mirai-graph 1.3.0 → 2.1.0

package/examples/self-service-onboarding/stale-graph/graph.json

@@ -1,36 +0,0 @@
-{
-  "$schema": "https://mirai-graph.dev/schemas/graph-manifest.schema.json",
-  "format": "mirai-graph",
-  "schema_version": "2.0.0",
-  "id": "package.synthetic_stale_graph",
-  "aliases": [],
-  "title": "Synthetic Stale Graph",
-  "scope": "package",
-  "kind": "graph_package",
-  "owner": "mirai-graph",
-  "profiles": [
-    "software_specification"
-  ],
-  "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": "Incomplete fixture for self-service detection.",
-  "public_safety": "synthetic_public"
-}

package/examples/semantic-intent-resolution-minimal/README.md

@@ -1,13 +0,0 @@
-# Semantic Intent Resolution Minimal Example
-
-This synthetic example shows how Mirai Graph can resolve a free-form request
-before execution starts.
-
-The example does not authorize work, update canonical graph state or bypass
-gates. It only records a governed intake decision.
-
-Validate:
-
-```bash
-npm run validate:semantic-intent-resolution
-```

package/examples/semantic-intent-resolution-minimal/invalid-low-confidence-executes.json

@@ -1,26 +0,0 @@
-{
-  "schema_version": "1.0.0",
-  "id": "semantic_intent_resolution.invalid.low-confidence-executes",
-  "user_request": "Make it normal.",
-  "intent_hypothesis": "Unclear request.",
-  "confidence": "low",
-  "work_scale": "batch",
-  "selected_chain_id": "general_delivery",
-  "process_model_id": "general_delivery",
-  "owner_role": "implementation_owner",
-  "required_context_slots": [
-    "target",
-    "acceptance_criteria"
-  ],
-  "missing_context_slots": [],
-  "safe_default_action": "Start implementation.",
-  "execution_allowed": true,
-  "review_surface_required": false,
-  "evidence_requirements": [
-    "diff"
-  ],
-  "canonical_write_allowed": false,
-  "limitations": [
-    "Invalid fixture: low confidence must not execute."
-  ]
-}

package/examples/semantic-intent-resolution-minimal/invalid-proposal-canonical-update.json

@@ -1,27 +0,0 @@
-{
-  "schema_version": "1.0.0",
-  "id": "semantic_intent_resolution.invalid.proposal-canonical-update",
-  "user_request": "Accept the generated proposal into the graph.",
-  "intent_hypothesis": "Canonical graph update request.",
-  "confidence": "high",
-  "work_scale": "batch",
-  "selected_chain_id": "graph_update_protocol",
-  "process_model_id": "graph_update",
-  "owner_role": "graph_owner",
-  "required_context_slots": [
-    "proposal",
-    "owner_review"
-  ],
-  "missing_context_slots": [],
-  "safe_default_action": "Apply the generated proposal.",
-  "execution_allowed": true,
-  "review_surface_required": false,
-  "evidence_requirements": [
-    "proposal"
-  ],
-  "proposal_updates_canonical": true,
-  "canonical_write_allowed": true,
-  "limitations": [
-    "Invalid fixture: generated proposals do not authorize canonical updates."
-  ]
-}

package/examples/semantic-intent-resolution-minimal/results/semantic-intent-resolution.json

@@ -1,45 +0,0 @@
-{
-  "schema_version": "1.0.0",
-  "id": "semantic_intent_resolution.synthetic.project-track-request",
-  "user_request": "Start this project and bring it to a working result.",
-  "intent_hypothesis": "The user is asking for a governed project track, not a single implementation batch.",
-  "confidence": "high",
-  "work_scale": "track",
-  "selected_chain_id": "track_start_protocol",
-  "process_model_id": "project_track_control",
-  "owner_role": "project_coordinator",
-  "companion_roles": [
-    "implementation_owner",
-    "quality_reviewer"
-  ],
-  "required_context_slots": [
-    "final_outcome",
-    "goal_queue",
-    "stop_conditions",
-    "evidence_plan"
-  ],
-  "missing_context_slots": [],
-  "clarifying_questions": [],
-  "safe_default_action": "Create a track contract and goal queue before starting implementation.",
-  "execution_allowed": false,
-  "review_surface_required": true,
-  "risk_flags": [],
-  "required_gates": [
-    "track_contract_review"
-  ],
-  "evidence_requirements": [
-    "track_contract",
-    "goal_queue",
-    "stop_conditions",
-    "evidence_plan"
-  ],
-  "dynamic_episode_ref": "examples/semantic-intent-resolution-minimal/results/intake-episode-placeholder.json",
-  "technology_quality_feedback_ref": null,
-  "canonical_write_allowed": false,
-  "limitations": [
-    "Semantic confidence is not authorization.",
-    "A generated brief does not approve execution.",
-    "The proposal does not update canonical graph state.",
-    "This synthetic example does not prove production readiness."
-  ]
-}

package/examples/skill-runtime-minimal/README.md

@@ -1,29 +0,0 @@
-# Minimal Skill Runtime Example
-
-Status: synthetic public fixture
-
-This example shows how the `skill_runtime` profile can model a governed skill
-or capability module without treating generated graph context as authorization.
-
-The fixture contains:
-
-- one synthetic skill;
-- one owner domain;
-- one capability and activity;
-- raw source and source-boundary objects;
-- semantic and effectiveness evidence objects;
-- runtime policy, fallback and projection view objects;
-- one federation contract placeholder.
-
-It intentionally does not include private source files, customer data,
-credentials, production logs or internal playbooks.
-
-## Boundary
-
-```text
-raw source -> graph objects -> projection view -> runtime context
-runtime policy -> fallback decision -> handoff or federation contract
-```
-
-The profile validates the graph shape. It does not prove that the synthetic
-skill is useful, safe or ready for production runtime.

package/examples/skill-runtime-minimal/gates/results.json

@@ -1,35 +0,0 @@
-[
-  {
-    "id": "gate_result.skill_runtime_minimal.public_safety",
-    "gate_id": "public_safety_before_release",
-    "target_id": "package.skill_runtime_minimal",
-    "verdict": "pass_with_notes",
-    "summary": "The fixture is synthetic and contains no private runtime, customer, employee or secret material.",
-    "reviewed_at": "2026-05-31",
-    "evidence": [
-      "evidence.skill_runtime_brief"
-    ]
-  },
-  {
-    "id": "gate_result.skill_runtime_minimal.semantic_preservation",
-    "gate_id": "semantic_preservation_before_runtime",
-    "target_id": "runtime_context.support_triage_compact",
-    "verdict": "needs_more_evidence",
-    "summary": "The fixture records the required semantic gate but does not claim an independent domain review.",
-    "reviewed_at": "2026-05-31",
-    "evidence": [
-      "evidence.skill_runtime_brief"
-    ]
-  },
-  {
-    "id": "gate_result.skill_runtime_minimal.runtime_enablement",
-    "gate_id": "runtime_enablement_before_primary_context",
-    "target_id": "runtime_policy.compact_context_allowed",
-    "verdict": "pass_with_notes",
-    "summary": "The runtime policy allows compact graph context only for measured non-sensitive routing tasks and requires fallback for sensitive work.",
-    "reviewed_at": "2026-05-31",
-    "evidence": [
-      "evidence.skill_runtime_brief"
-    ]
-  }
-]

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

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

@@ -1,178 +0,0 @@
-[
-  {
-    "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/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.skill_runtime_minimal",
-  "aliases": [],
-  "title": "Minimal Skill Runtime Example",
-  "scope": "package",
-  "kind": "graph_package",
-  "owner": "mirai-graph",
-  "profiles": [
-    "skill_runtime"
-  ],
-  "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 governed skill runtime context with Hybrid Source Of Truth boundaries.",
-  "license": "CC-BY-4.0",
-  "public_safety": "synthetic_public"
-}

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

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