mirai-graph 1.3.0 → 2.1.0

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

@@ -1,165 +0,0 @@
-[
-  {
-    "id": "evidence.character_layer_brief",
-    "kind": "evidence",
-    "title": "Character Layer Brief",
-    "summary": "Public-safe synthetic brief for the minimal Character Layer profile fixture.",
-    "readiness": "accepted",
-    "evidence": [],
-    "profile": "character_layer"
-  },
-  {
-    "id": "character_constitution.mirai_base_public",
-    "kind": "character_constitution",
-    "title": "Mirai Base Public Character Constitution",
-    "summary": "Public-safe base constitution for modeling portable AI character boundaries.",
-    "readiness": "draft",
-    "evidence": [
-      "evidence.character_layer_brief"
-    ],
-    "profile": "character_layer"
-  },
-  {
-    "id": "character_principle.expose_uncertainty",
-    "kind": "character_principle",
-    "title": "Expose Uncertainty",
-    "summary": "Separate verified facts, memory-derived context, inference and unknowns.",
-    "readiness": "draft",
-    "evidence": [
-      "evidence.character_layer_brief"
-    ],
-    "profile": "character_layer"
-  },
-  {
-    "id": "character_principle.preserve_authority_boundary",
-    "kind": "character_principle",
-    "title": "Preserve Authority Boundary",
-    "summary": "Keep generated context, recommendations, approvals and external actions in separate states.",
-    "readiness": "draft",
-    "evidence": [
-      "evidence.character_layer_brief"
-    ],
-    "profile": "character_layer"
-  },
-  {
-    "id": "character_principle.report_evidence_and_blockers",
-    "kind": "character_principle",
-    "title": "Report Evidence And Blockers",
-    "summary": "Report completed work, evidence, blockers, remaining work and the next safe action.",
-    "readiness": "draft",
-    "evidence": [
-      "evidence.character_layer_brief"
-    ],
-    "profile": "character_layer"
-  },
-  {
-    "id": "character_virtue.evidence_honesty",
-    "kind": "character_virtue",
-    "title": "Evidence Honesty",
-    "summary": "State what is known, what was checked and what still needs validation.",
-    "readiness": "draft",
-    "evidence": [
-      "evidence.character_layer_brief"
-    ],
-    "profile": "character_layer"
-  },
-  {
-    "id": "character_virtue.boundary_discipline",
-    "kind": "character_virtue",
-    "title": "Boundary Discipline",
-    "summary": "Keep reasoning support, generated context, permission and execution in their own layers.",
-    "readiness": "draft",
-    "evidence": [
-      "evidence.character_layer_brief"
-    ],
-    "profile": "character_layer"
-  },
-  {
-    "id": "character_boundary.no_generated_authorization",
-    "kind": "character_boundary",
-    "title": "Generated Context Is Not Authorization",
-    "summary": "Generated context may guide reasoning but cannot authorize external action or canonical writes.",
-    "readiness": "accepted",
-    "evidence": [
-      "evidence.character_layer_brief"
-    ],
-    "profile": "character_layer"
-  },
-  {
-    "id": "character_boundary.no_secret_exposure",
-    "kind": "character_boundary",
-    "title": "Secret Exposure Boundary",
-    "summary": "Credentials, tokens, private keys and raw secret values stay outside public graph packages.",
-    "readiness": "accepted",
-    "evidence": [
-      "evidence.character_layer_brief"
-    ],
-    "profile": "character_layer"
-  },
-  {
-    "id": "reflection_protocol.final_response_boundary",
-    "kind": "reflection_protocol",
-    "title": "Final Response Boundary Reflection",
-    "summary": "Check completed work, evidence, blockers, next safe action and remaining work before final reporting.",
-    "readiness": "draft",
-    "evidence": [
-      "evidence.character_layer_brief"
-    ],
-    "profile": "character_layer"
-  },
-  {
-    "id": "role_character_profile.federation_operator",
-    "kind": "role_character_profile",
-    "title": "Federation Operator Character Profile",
-    "summary": "Synthetic role profile for federation coordination: route correctly, preserve boundaries and report evidence.",
-    "readiness": "draft",
-    "evidence": [
-      "evidence.character_layer_brief"
-    ],
-    "profile": "character_layer"
-  },
-  {
-    "id": "character_fixture.analysis_boundary",
-    "kind": "character_fixture",
-    "title": "Analysis Boundary Fixture",
-    "summary": "Fixture where the expected behavior is discussion and review mode until the owner approves repository writes.",
-    "readiness": "draft",
-    "evidence": [
-      "evidence.character_layer_brief"
-    ],
-    "profile": "character_layer"
-  },
-  {
-    "id": "violation_pattern.false_completion_claim",
-    "kind": "violation_pattern",
-    "title": "False Completion Claim",
-    "summary": "Pattern where a result is described as complete before required evidence, review or validation exists.",
-    "readiness": "draft",
-    "evidence": [
-      "evidence.character_layer_brief"
-    ],
-    "profile": "character_layer"
-  },
-  {
-    "id": "correction_loop.owner_reviewed_update",
-    "kind": "correction_loop",
-    "title": "Owner Reviewed Character Update",
-    "summary": "Correction loop where feedback becomes a proposed update and canonical character state changes only after owner review.",
-    "readiness": "draft",
-    "evidence": [
-      "evidence.character_layer_brief"
-    ],
-    "profile": "character_layer"
-  },
-  {
-    "id": "governance_gate.character_public_safety",
-    "kind": "governance_gate",
-    "title": "Character Public Safety Gate",
-    "summary": "Gate checking that public character examples contain only synthetic public-safe content.",
-    "readiness": "accepted",
-    "evidence": [
-      "evidence.character_layer_brief"
-    ],
-    "profile": "character_layer"
-  }
-]

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

@@ -1,178 +0,0 @@
-[
-  {
-    "id": "relation.character_constitution.mirai_base_public.defines_principle.character_principle.expose_uncertainty",
-    "type": "defines_principle",
-    "source": "character_constitution.mirai_base_public",
-    "target": "character_principle.expose_uncertainty",
-    "readiness": "draft",
-    "evidence": [
-      "evidence.character_layer_brief"
-    ],
-    "profile": "character_layer"
-  },
-  {
-    "id": "relation.character_constitution.mirai_base_public.defines_principle.character_principle.preserve_authority_boundary",
-    "type": "defines_principle",
-    "source": "character_constitution.mirai_base_public",
-    "target": "character_principle.preserve_authority_boundary",
-    "readiness": "draft",
-    "evidence": [
-      "evidence.character_layer_brief"
-    ],
-    "profile": "character_layer"
-  },
-  {
-    "id": "relation.character_constitution.mirai_base_public.defines_principle.character_principle.report_evidence_and_blockers",
-    "type": "defines_principle",
-    "source": "character_constitution.mirai_base_public",
-    "target": "character_principle.report_evidence_and_blockers",
-    "readiness": "draft",
-    "evidence": [
-      "evidence.character_layer_brief"
-    ],
-    "profile": "character_layer"
-  },
-  {
-    "id": "relation.character_constitution.mirai_base_public.promotes_virtue.character_virtue.evidence_honesty",
-    "type": "promotes_virtue",
-    "source": "character_constitution.mirai_base_public",
-    "target": "character_virtue.evidence_honesty",
-    "readiness": "draft",
-    "evidence": [
-      "evidence.character_layer_brief"
-    ],
-    "profile": "character_layer"
-  },
-  {
-    "id": "relation.character_constitution.mirai_base_public.promotes_virtue.character_virtue.boundary_discipline",
-    "type": "promotes_virtue",
-    "source": "character_constitution.mirai_base_public",
-    "target": "character_virtue.boundary_discipline",
-    "readiness": "draft",
-    "evidence": [
-      "evidence.character_layer_brief"
-    ],
-    "profile": "character_layer"
-  },
-  {
-    "id": "relation.character_constitution.mirai_base_public.sets_character_boundary.character_boundary.no_generated_authorization",
-    "type": "sets_character_boundary",
-    "source": "character_constitution.mirai_base_public",
-    "target": "character_boundary.no_generated_authorization",
-    "readiness": "accepted",
-    "evidence": [
-      "evidence.character_layer_brief"
-    ],
-    "profile": "character_layer"
-  },
-  {
-    "id": "relation.character_constitution.mirai_base_public.sets_character_boundary.character_boundary.no_secret_exposure",
-    "type": "sets_character_boundary",
-    "source": "character_constitution.mirai_base_public",
-    "target": "character_boundary.no_secret_exposure",
-    "readiness": "accepted",
-    "evidence": [
-      "evidence.character_layer_brief"
-    ],
-    "profile": "character_layer"
-  },
-  {
-    "id": "relation.role_character_profile.federation_operator.specializes_character.character_constitution.mirai_base_public",
-    "type": "specializes_character",
-    "source": "role_character_profile.federation_operator",
-    "target": "character_constitution.mirai_base_public",
-    "readiness": "draft",
-    "evidence": [
-      "evidence.character_layer_brief"
-    ],
-    "profile": "character_layer"
-  },
-  {
-    "id": "relation.role_character_profile.federation_operator.uses_reflection_protocol.reflection_protocol.final_response_boundary",
-    "type": "uses_reflection_protocol",
-    "source": "role_character_profile.federation_operator",
-    "target": "reflection_protocol.final_response_boundary",
-    "readiness": "draft",
-    "evidence": [
-      "evidence.character_layer_brief"
-    ],
-    "profile": "character_layer"
-  },
-  {
-    "id": "relation.character_fixture.analysis_boundary.tests_character.role_character_profile.federation_operator",
-    "type": "tests_character",
-    "source": "character_fixture.analysis_boundary",
-    "target": "role_character_profile.federation_operator",
-    "readiness": "draft",
-    "evidence": [
-      "evidence.character_layer_brief"
-    ],
-    "profile": "character_layer"
-  },
-  {
-    "id": "relation.violation_pattern.false_completion_claim.describes_violation_of.character_principle.report_evidence_and_blockers",
-    "type": "describes_violation_of",
-    "source": "violation_pattern.false_completion_claim",
-    "target": "character_principle.report_evidence_and_blockers",
-    "readiness": "draft",
-    "evidence": [
-      "evidence.character_layer_brief"
-    ],
-    "profile": "character_layer"
-  },
-  {
-    "id": "relation.correction_loop.owner_reviewed_update.corrects_violation.violation_pattern.false_completion_claim",
-    "type": "corrects_violation",
-    "source": "correction_loop.owner_reviewed_update",
-    "target": "violation_pattern.false_completion_claim",
-    "readiness": "draft",
-    "evidence": [
-      "evidence.character_layer_brief"
-    ],
-    "profile": "character_layer"
-  },
-  {
-    "id": "relation.correction_loop.owner_reviewed_update.updates_character.role_character_profile.federation_operator",
-    "type": "updates_character",
-    "source": "correction_loop.owner_reviewed_update",
-    "target": "role_character_profile.federation_operator",
-    "readiness": "draft",
-    "evidence": [
-      "evidence.character_layer_brief"
-    ],
-    "profile": "character_layer"
-  },
-  {
-    "id": "relation.evidence.character_layer_brief.evidences_character.character_constitution.mirai_base_public",
-    "type": "evidences_character",
-    "source": "evidence.character_layer_brief",
-    "target": "character_constitution.mirai_base_public",
-    "readiness": "accepted",
-    "evidence": [
-      "evidence.character_layer_brief"
-    ],
-    "profile": "character_layer"
-  },
-  {
-    "id": "relation.governance_gate.character_public_safety.governs.role_character_profile.federation_operator",
-    "type": "governs",
-    "source": "governance_gate.character_public_safety",
-    "target": "role_character_profile.federation_operator",
-    "readiness": "accepted",
-    "evidence": [
-      "evidence.character_layer_brief"
-    ],
-    "profile": "character_layer"
-  },
-  {
-    "id": "relation.character_boundary.no_generated_authorization.requires_escalation_to.governance_gate.character_public_safety",
-    "type": "requires_escalation_to",
-    "source": "character_boundary.no_generated_authorization",
-    "target": "governance_gate.character_public_safety",
-    "readiness": "accepted",
-    "evidence": [
-      "evidence.character_layer_brief"
-    ],
-    "profile": "character_layer"
-  }
-]

package/examples/character-layer-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.character_layer_minimal",
-  "aliases": [],
-  "title": "Minimal Character Layer Example",
-  "scope": "package",
-  "kind": "graph_package",
-  "owner": "mirai-graph",
-  "profiles": [
-    "character_layer"
-  ],
-  "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 Mirai Graph package showing a public-safe character constitution, principles, character boundaries, reflection, fixture and correction loop.",
-  "license": "CC-BY-4.0",
-  "public_safety": "synthetic_public"
-}

package/examples/character-layer-readiness-1-0/README.md

@@ -1,27 +0,0 @@
-# Character Layer 1.0 Readiness
-
-This example is the public-safe readiness consolidation for the Character Layer
-track.
-
-It links:
-
-- profile vocabulary;
-- minimal fixture;
-- starter pack;
-- semantic negative fixtures;
-- cross-layer integration;
-- model portability evidence;
-- validation commands;
-- claim boundaries and remaining limits.
-
-Validate:
-
-```bash
-node packages/cli/validate-mirai-graph.js character-layer-readiness examples/character-layer-readiness-1-0/results/character-layer-readiness.json
-```
-
-## Boundary
-
-The readiness verdict is a Mirai Graph 1.0 candidate readiness statement for
-this profile track. It is not peer-reviewed scientific proof and does not
-authorize production model replacement or autonomous runtime execution.

package/examples/character-layer-readiness-1-0/results/character-layer-readiness.json

@@ -1,90 +0,0 @@
-{
-  "schema_version": "0.1.0",
-  "profile": "character_layer",
-  "public_safety": "synthetic_public",
-  "readiness_id": "character_layer_readiness.1_0_candidate",
-  "target_release_track": "mirai_graph_1_0",
-  "readiness_verdict": "ready_for_1_0_candidate",
-  "completed_capabilities": [
-    {
-      "id": "profile_vocabulary",
-      "status": "completed",
-      "evidence_refs": [
-        "profiles/character-layer/profile.json",
-        "profiles/character-layer/README.md"
-      ]
-    },
-    {
-      "id": "minimal_fixture",
-      "status": "completed",
-      "evidence_refs": [
-        "examples/character-layer-minimal/"
-      ]
-    },
-    {
-      "id": "starter_pack",
-      "status": "completed",
-      "evidence_refs": [
-        "templates/character-layer-starter/"
-      ]
-    },
-    {
-      "id": "semantic_negative_fixtures",
-      "status": "completed",
-      "evidence_refs": [
-        "examples/invalid-character-layer-context-authorization/",
-        "examples/invalid-character-layer-feedback-auto-update/",
-        "examples/invalid-character-layer-role-permission/",
-        "examples/invalid-character-layer-correction-loop-no-review/",
-        "examples/invalid-character-layer-relation-direction/"
-      ]
-    },
-    {
-      "id": "cross_layer_integration",
-      "status": "completed",
-      "evidence_refs": [
-        "schemas/character-layer-integration.schema.json",
-        "examples/character-layer-integration-minimal/results/character-layer-integration.json"
-      ]
-    },
-    {
-      "id": "model_portability_evidence_shape",
-      "status": "completed",
-      "evidence_refs": [
-        "schemas/model-portability-evidence.schema.json",
-        "examples/model-portability-minimal/results/model-portability-evidence.json"
-      ]
-    }
-  ],
-  "validation_commands": [
-    "npm run validate:character-layer",
-    "npm run validate:character-layer-starter",
-    "npm run validate:character-layer-integration",
-    "npm run validate:model-portability-evidence",
-    "npm run test:character-layer-semantic-negative",
-    "npm run validate:character-layer-readiness",
-    "npm test",
-    "npm run release:check"
-  ],
-  "evidence_refs": [
-    "docs/adoption/character-layer.md",
-    "templates/character-layer-starter/",
-    "examples/character-layer-integration-minimal/",
-    "examples/model-portability-minimal/",
-    "examples/character-layer-readiness-1-0/"
-  ],
-  "claim_boundaries": [
-    "Character Layer can be represented as a reusable Mirai Graph behavior-governance profile.",
-    "Character Layer can be composed with AI employee, process-control, technology-quality-feedback and runtime context through a checked integration artifact.",
-    "Model portability can be measured through bounded fixture evidence.",
-    "A portable-within-fixture-limits verdict does not prove broad model equivalence.",
-    "Generated context, evidence, feedback and proposals do not authorize canonical updates."
-  ],
-  "remaining_limits": [
-    "No live multi-model replay evidence is included in the public package.",
-    "No peer-reviewed scientific proof is claimed.",
-    "No production autonomous execution safety is claimed.",
-    "Real model replacement remains dependent on reasoning quality, coding ability, long-context handling and project-specific review.",
-    "Private operational constitutions remain outside public examples."
-  ]
-}

package/examples/dynamic-episode-minimal/README.md

@@ -1,34 +0,0 @@
-# Dynamic Episode Minimal Example
-
-Status: proposal/experimental synthetic example
-
-This example shows how a Mirai Graph package can record a trace for one
-AI-assisted code-generation episode.
-
-The episode demonstrates:
-
-- event input;
-- graph object and relation activation;
-- selected workflow path;
-- blocked unsafe alternatives;
-- gates;
-- findings;
-- feedback classification;
-- Kaizen candidate;
-- replay/regression placeholder;
-- explicit `canonical_write_allowed=false`.
-
-The example is synthetic. It does not claim real-world code-generation
-improvement, production readiness or scientific proof.
-
-Validate it with:
-
-```bash
-npm run validate:dynamic-episodes
-```
-
-Negative fixtures are intentionally invalid and are checked by:
-
-```bash
-npm run test:dynamic-episodes-negative
-```

package/examples/dynamic-episode-minimal/gates/results.json

@@ -1,12 +0,0 @@
-[
-  {
-    "id": "gate.dynamic_episode_boundary_result",
-    "gate_id": "gate.dynamic_episode_boundary",
-    "target_id": "feature.synthetic_login_audit",
-    "verdict": "pass",
-    "summary": "Synthetic example keeps runtime trace separate from canonical graph update.",
-    "evidence": ["evidence.synthetic_boundary_rule"],
-    "reviewed_at": "2026-06-16",
-    "reviewer": "Mirai Graph maintainers"
-  }
-]

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

@@ -1,92 +0,0 @@
-[
-  {
-    "id": "system.synthetic_code_project",
-    "kind": "system",
-    "profile": "core",
-    "title": "Synthetic Code Project",
-    "summary": "A public-safe project used to demonstrate dynamic episode tracing.",
-    "readiness": "draft",
-    "evidence": ["evidence.synthetic_project_seed"]
-  },
-  {
-    "id": "feature.synthetic_login_audit",
-    "kind": "feature",
-    "profile": "core",
-    "title": "Synthetic Login Audit Feature",
-    "summary": "A bounded feature used for a code-generation episode.",
-    "readiness": "draft",
-    "evidence": ["evidence.synthetic_feature_spec"]
-  },
-  {
-    "id": "requirement.synthetic_allowed_scope",
-    "kind": "requirement",
-    "profile": "core",
-    "title": "Allowed File Scope",
-    "summary": "The episode must keep changes inside the declared feature scope.",
-    "readiness": "review_ready",
-    "evidence": ["evidence.synthetic_scope_contract"]
-  },
-  {
-    "id": "governance_gate.dynamic_episode_boundary",
-    "kind": "governance_gate",
-    "profile": "core",
-    "title": "Dynamic Episode Boundary Gate",
-    "summary": "Episode traces and evidence cannot authorize canonical updates.",
-    "readiness": "review_ready",
-    "evidence": ["evidence.synthetic_boundary_rule"]
-  },
-  {
-    "id": "evidence.synthetic_episode_trace",
-    "kind": "evidence",
-    "profile": "core",
-    "title": "Synthetic Episode Trace Evidence",
-    "summary": "Synthetic evidence for the dynamic episode trace example.",
-    "readiness": "draft",
-    "evidence": ["evidence.synthetic_public_source"]
-  },
-  {
-    "id": "evidence.synthetic_feature_spec",
-    "kind": "evidence",
-    "profile": "core",
-    "title": "Synthetic Feature Spec",
-    "summary": "Public-safe synthetic feature specification evidence.",
-    "readiness": "draft",
-    "evidence": ["evidence.synthetic_public_source"]
-  },
-  {
-    "id": "evidence.synthetic_scope_contract",
-    "kind": "evidence",
-    "profile": "core",
-    "title": "Synthetic Scope Contract",
-    "summary": "Public-safe synthetic allowed-scope evidence.",
-    "readiness": "draft",
-    "evidence": ["evidence.synthetic_public_source"]
-  },
-  {
-    "id": "evidence.synthetic_boundary_rule",
-    "kind": "evidence",
-    "profile": "core",
-    "title": "Synthetic Boundary Rule",
-    "summary": "Public-safe evidence that traces are not authorization.",
-    "readiness": "review_ready",
-    "evidence": ["evidence.synthetic_public_source"]
-  },
-  {
-    "id": "evidence.synthetic_project_seed",
-    "kind": "evidence",
-    "profile": "core",
-    "title": "Synthetic Project Seed",
-    "summary": "Public-safe synthetic project seed evidence.",
-    "readiness": "draft",
-    "evidence": ["evidence.synthetic_public_source"]
-  },
-  {
-    "id": "evidence.synthetic_public_source",
-    "kind": "evidence",
-    "profile": "core",
-    "title": "Synthetic Public Source",
-    "summary": "Internal source marker for synthetic examples.",
-    "readiness": "draft",
-    "evidence": []
-  }
-]

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

@@ -1,29 +0,0 @@
-[
-  {
-    "id": "relation.feature.synthetic_login_audit.depends_on.requirement.synthetic_allowed_scope",
-    "type": "depends_on",
-    "profile": "core",
-    "source": "feature.synthetic_login_audit",
-    "target": "requirement.synthetic_allowed_scope",
-    "readiness": "draft",
-    "evidence": ["evidence.synthetic_feature_spec"]
-  },
-  {
-    "id": "relation.governance_gate.dynamic_episode_boundary.governs.feature.synthetic_login_audit",
-    "type": "governs",
-    "profile": "core",
-    "source": "governance_gate.dynamic_episode_boundary",
-    "target": "feature.synthetic_login_audit",
-    "readiness": "review_ready",
-    "evidence": ["evidence.synthetic_boundary_rule"]
-  },
-  {
-    "id": "relation.evidence.synthetic_episode_trace.evidences.feature.synthetic_login_audit",
-    "type": "evidences",
-    "profile": "core",
-    "source": "evidence.synthetic_episode_trace",
-    "target": "feature.synthetic_login_audit",
-    "readiness": "draft",
-    "evidence": ["evidence.synthetic_episode_trace"]
-  }
-]