mirai-graph 1.3.0 → 2.1.0

package/examples/process-transition-minimal/state-machine.json

@@ -1,79 +0,0 @@
-{
-  "schema_version": "0.1.0",
-  "id": "work_state_machine.synthetic_executable_process",
-  "profile": "implementation_control",
-  "public_safety": "synthetic_public",
-  "states": [
-    "planned",
-    "ready_to_execute",
-    "started",
-    "written",
-    "tests_recorded",
-    "evidence_recorded",
-    "sync_proposed",
-    "approved",
-    "release_ready",
-    "released",
-    "kaizen_reviewed"
-  ],
-  "terminal_states": ["released", "kaizen_reviewed"],
-  "transitions": [
-    {
-      "from": "planned",
-      "to": "ready_to_execute",
-      "requires_evidence": ["launch_record"],
-      "requires_launch_record": true
-    },
-    {
-      "from": "ready_to_execute",
-      "to": "started",
-      "requires_evidence": ["scope_check"],
-      "requires_launch_record": true
-    },
-    {
-      "from": "started",
-      "to": "written",
-      "requires_evidence": ["file_map"]
-    },
-    {
-      "from": "written",
-      "to": "tests_recorded",
-      "requires_evidence": ["test_result"]
-    },
-    {
-      "from": "tests_recorded",
-      "to": "evidence_recorded",
-      "requires_evidence": ["semantic_acceptance", "evidence_pack"]
-    },
-    {
-      "from": "evidence_recorded",
-      "to": "sync_proposed",
-      "requires_evidence": ["sync_proposal"]
-    },
-    {
-      "from": "sync_proposed",
-      "to": "approved",
-      "requires_evidence": ["approval_gate"]
-    },
-    {
-      "from": "approved",
-      "to": "release_ready",
-      "requires_evidence": ["release_gate"]
-    },
-    {
-      "from": "release_ready",
-      "to": "released",
-      "requires_evidence": ["release_evidence"],
-      "terminal_requires_kaizen": true
-    }
-  ],
-  "false_transition_guards": [
-    "ready_to_execute_is_not_written",
-    "tests_recorded_without_semantic_acceptance_is_not_approved",
-    "sync_proposed_is_not_controlled_update",
-    "released_requires_release_evidence",
-    "terminal_requires_kaizen_or_no_reusable_lessons"
-  ],
-  "evidence_refs": ["evidence.synthetic_transition_brief"],
-  "limitations": ["Synthetic state machine validates transition rules, not real execution."]
-}

package/examples/process-transition-minimal/transition-request-skip-kaizen.json

@@ -1,14 +0,0 @@
-{
-  "schema_version": "0.1.0",
-  "id": "transition_request.release_ready_to_released_skip_kaizen",
-  "profile": "implementation_control",
-  "public_safety": "synthetic_public",
-  "process_id": "process.synthetic_executable_standard",
-  "current_state": "release_ready",
-  "target_state": "released",
-  "evidence_refs": ["release_evidence"],
-  "launch_record_ref": "launch_record.synthetic_batch",
-  "kaizen_review_ref": "",
-  "no_reusable_lessons_reason": "Synthetic release produced no reusable process lesson after review.",
-  "limitations": ["Explicit skip reason is allowed only when no reusable lessons were found."]
-}

package/examples/process-transition-minimal/transition-request.json

@@ -1,14 +0,0 @@
-{
-  "schema_version": "0.1.0",
-  "id": "transition_request.release_ready_to_released",
-  "profile": "implementation_control",
-  "public_safety": "synthetic_public",
-  "process_id": "process.synthetic_executable_standard",
-  "current_state": "release_ready",
-  "target_state": "released",
-  "evidence_refs": ["release_evidence"],
-  "launch_record_ref": "launch_record.synthetic_batch",
-  "kaizen_review_ref": "kaizen_review.synthetic_release",
-  "no_reusable_lessons_reason": "",
-  "limitations": ["Synthetic request proves validator behavior, not production safety."]
-}

package/examples/project-technology-context-traversal/README.md

@@ -1,17 +0,0 @@
-# Project Technology Context Traversal
-
-This synthetic example shows a domain-neutral release graph with a three-level
-path, mandatory rollback and validation dependencies, and one optional branch.
-
-Start with discovery:
-
-```bash
-mirai-graph technology context . --phase discover --task "prepare and verify a release"
-```
-
-Save the returned `traversal_receipt`, expand the selected capability and
-process, then copy the returned task and graph digests into
-`selection.example.json`. Compilation adds the rollback constraint and release
-smoke even if the selector did not name them.
-
-All operations are read-only. The example contains synthetic public data only.

package/examples/project-technology-context-traversal/graph/objects.json

@@ -1,78 +0,0 @@
-[
-  {
-    "id": "capability.release_delivery",
-    "kind": "capability",
-    "title": "Release delivery",
-    "summary": "Prepare a bounded and verifiable software release.",
-    "owner": "role.release_owner",
-    "readiness": "accepted",
-    "authority": "contract",
-    "expansion_policy": "expandable",
-    "evidence": [],
-    "profile": "core"
-  },
-  {
-    "id": "process.release_verification",
-    "kind": "process",
-    "title": "Release verification",
-    "summary": "Run the accepted release checks before publication.",
-    "owner": "role.release_owner",
-    "readiness": "accepted",
-    "authority": "contract",
-    "expansion_policy": "expandable",
-    "evidence": [],
-    "profile": "core"
-  },
-  {
-    "id": "source.release_guide",
-    "kind": "source",
-    "title": "Release guide",
-    "summary": "The authoritative local guide for the synthetic release.",
-    "owner": "role.release_owner",
-    "readiness": "accepted",
-    "authority": "source",
-    "expansion_policy": "terminal",
-    "source_refs": ["sources/release-guide.md"],
-    "evidence": [],
-    "profile": "core"
-  },
-  {
-    "id": "constraint.rollback_required",
-    "kind": "constraint",
-    "title": "Rollback is required",
-    "summary": "Publication must retain a tested rollback path.",
-    "owner": "role.release_owner",
-    "readiness": "accepted",
-    "authority": "contract",
-    "expansion_policy": "terminal",
-    "source_refs": ["sources/rollback-policy.md"],
-    "evidence": [],
-    "profile": "core"
-  },
-  {
-    "id": "check.release_smoke",
-    "kind": "check",
-    "title": "Release smoke",
-    "summary": "Verify the installed release identity and core behavior.",
-    "owner": "role.release_quality",
-    "readiness": "accepted",
-    "authority": "validator",
-    "expansion_policy": "terminal",
-    "source_refs": ["sources/release-smoke.md"],
-    "evidence": [],
-    "profile": "core"
-  },
-  {
-    "id": "capability.optional_announcement",
-    "kind": "capability",
-    "title": "Optional announcement",
-    "summary": "Prepare a public announcement only when requested.",
-    "owner": "role.communication",
-    "readiness": "accepted",
-    "authority": "reference",
-    "expansion_policy": "terminal",
-    "source_refs": ["sources/announcement.md"],
-    "evidence": [],
-    "profile": "core"
-  }
-]

package/examples/project-technology-context-traversal/graph/relations.json

@@ -1,47 +0,0 @@
-[
-  {
-    "id": "relation.capability.release_delivery.contains.process.release_verification",
-    "type": "contains",
-    "source": "capability.release_delivery",
-    "target": "process.release_verification",
-    "readiness": "accepted",
-    "evidence": [],
-    "profile": "core"
-  },
-  {
-    "id": "relation.process.release_verification.documented_by.source.release_guide",
-    "type": "documented_by",
-    "source": "process.release_verification",
-    "target": "source.release_guide",
-    "readiness": "accepted",
-    "evidence": [],
-    "profile": "core"
-  },
-  {
-    "id": "relation.process.release_verification.governed_by.constraint.rollback_required",
-    "type": "governed_by",
-    "source": "process.release_verification",
-    "target": "constraint.rollback_required",
-    "readiness": "accepted",
-    "evidence": [],
-    "profile": "core"
-  },
-  {
-    "id": "relation.process.release_verification.validated_by.check.release_smoke",
-    "type": "validated_by",
-    "source": "process.release_verification",
-    "target": "check.release_smoke",
-    "readiness": "accepted",
-    "evidence": [],
-    "profile": "core"
-  },
-  {
-    "id": "relation.capability.release_delivery.contains.capability.optional_announcement",
-    "type": "contains",
-    "source": "capability.release_delivery",
-    "target": "capability.optional_announcement",
-    "readiness": "accepted",
-    "evidence": [],
-    "profile": "core"
-  }
-]

package/examples/project-technology-context-traversal/graph.json

@@ -1,30 +0,0 @@
-{
-  "$schema": "https://mirai-graph.dev/schemas/graph-manifest.schema.json",
-  "format": "mirai-graph",
-  "schema_version": "2.0.0",
-  "id": "example.project_technology_context_traversal",
-  "aliases": [],
-  "title": "Project Technology Context Traversal Example",
-  "scope": "repository",
-  "kind": "project_graph",
-  "owner": "example.delivery_owner",
-  "profiles": [],
-  "graph": {
-    "root": "graph",
-    "source_of_truth": ["graph"],
-    "objects": ["graph/objects.json"],
-    "relations": ["graph/relations.json"],
-    "schemas": [],
-    "generated": [],
-    "raw_sources": ["sources"]
-  },
-  "imports": [],
-  "extensions": {
-    "mirai.project_technology": {
-      "contract_version": "1.0.0",
-      "enabled": true,
-      "context_policy": "task_scoped",
-      "source_boundary": "hybrid_sot"
-    }
-  }
-}

package/examples/project-technology-context-traversal/selection.example.json

@@ -1,29 +0,0 @@
-{
-  "selector": "human",
-  "task_digest": "replace-with-discover-task-digest",
-  "graph_digest": "replace-with-discover-graph-digest",
-  "result_owner_id": "role.release_owner",
-  "selected": [
-    {
-      "id": "capability.release_delivery",
-      "reason": "The requested outcome is a release.",
-      "confidence": 1
-    },
-    {
-      "id": "process.release_verification",
-      "reason": "The release must be verified before publication.",
-      "confidence": 1
-    },
-    {
-      "id": "source.release_guide",
-      "reason": "This is the accepted release source.",
-      "confidence": 1
-    }
-  ],
-  "rejected": [
-    {
-      "id": "capability.optional_announcement",
-      "reason": "An announcement was not requested."
-    }
-  ]
-}

package/examples/project-technology-context-traversal/sources/announcement.md

@@ -1,3 +0,0 @@
-# Optional announcement
-
-Publish an announcement only when it belongs to the accepted release scope.

package/examples/project-technology-context-traversal/sources/release-guide.md

@@ -1,3 +0,0 @@
-# Release guide
-
-Build once, verify the exact artifact, and publish only that artifact.

package/examples/project-technology-context-traversal/sources/release-smoke.md

@@ -1,3 +0,0 @@
-# Release smoke
-
-Check the installed version, package checksum and one representative operation.

package/examples/project-technology-context-traversal/sources/rollback-policy.md

@@ -1,3 +0,0 @@
-# Rollback policy
-
-Keep the previous immutable version available until the new version is verified.

package/examples/risk-and-coordination-minimal/README.md

@@ -1,16 +0,0 @@
-# Risk And Coordination Minimal Example
-
-Status: synthetic public example
-
-## Purpose
-
-This example shows a public-safe risk control matrix and multi-agent
-coordination contract.
-
-## Validation
-
-Run:
-
-```bash
-npm run validate:risk-control
-```

package/examples/risk-and-coordination-minimal/graph/objects.json

@@ -1,47 +0,0 @@
-[
-  {
-    "id": "evidence.synthetic_risk_brief",
-    "kind": "evidence",
-    "title": "Synthetic Risk Brief",
-    "summary": "Public-safe brief for risk control and coordination.",
-    "readiness": "accepted",
-    "evidence": [],
-    "profile": "implementation_control"
-  },
-  {
-    "id": "risk.false_readiness",
-    "kind": "risk_control",
-    "title": "False Readiness",
-    "summary": "Risk that a ready state is treated as completed work.",
-    "readiness": "review_ready",
-    "evidence": ["evidence.synthetic_risk_brief"],
-    "profile": "implementation_control"
-  },
-  {
-    "id": "risk.write_collision",
-    "kind": "risk_control",
-    "title": "Write Collision",
-    "summary": "Risk that two workers update the same scope without coordination.",
-    "readiness": "review_ready",
-    "evidence": ["evidence.synthetic_risk_brief"],
-    "profile": "implementation_control"
-  },
-  {
-    "id": "coordination.synthetic_review_team",
-    "kind": "coordination_contract",
-    "title": "Synthetic Review Team Coordination",
-    "summary": "Contract for coordinating several workers on bounded synthetic scopes.",
-    "readiness": "review_ready",
-    "evidence": ["evidence.synthetic_risk_brief"],
-    "profile": "implementation_control"
-  },
-  {
-    "id": "reservation.review_scope",
-    "kind": "agent_reservation",
-    "title": "Review Scope Reservation",
-    "summary": "Reservation assigning one worker to a bounded review scope.",
-    "readiness": "accepted",
-    "evidence": ["evidence.synthetic_risk_brief"],
-    "profile": "implementation_control"
-  }
-]

package/examples/risk-and-coordination-minimal/graph/relations.json

@@ -1,29 +0,0 @@
-[
-  {
-    "id": "relation.coordination.synthetic_review_team.controls_risk.risk.write_collision",
-    "type": "controls_risk",
-    "source": "coordination.synthetic_review_team",
-    "target": "risk.write_collision",
-    "readiness": "review_ready",
-    "evidence": ["evidence.synthetic_risk_brief"],
-    "profile": "implementation_control"
-  },
-  {
-    "id": "relation.reservation.review_scope.reserves_scope.coordination.synthetic_review_team",
-    "type": "reserves_scope",
-    "source": "reservation.review_scope",
-    "target": "coordination.synthetic_review_team",
-    "readiness": "accepted",
-    "evidence": ["evidence.synthetic_risk_brief"],
-    "profile": "implementation_control"
-  },
-  {
-    "id": "relation.risk.false_readiness.blocks.coordination.synthetic_review_team",
-    "type": "blocks",
-    "source": "risk.false_readiness",
-    "target": "coordination.synthetic_review_team",
-    "readiness": "review_ready",
-    "evidence": ["evidence.synthetic_risk_brief"],
-    "profile": "implementation_control"
-  }
-]

package/examples/risk-and-coordination-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.risk_and_coordination_minimal",
-  "aliases": [],
-  "title": "Risk And Coordination 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 risk controls and multi-agent coordination.",
-  "license": "CC-BY-4.0",
-  "public_safety": "synthetic_public"
-}

package/examples/risk-and-coordination-minimal/results/multi-agent-coordination.json

@@ -1,25 +0,0 @@
-{
-  "schema_version": "0.1.0",
-  "id": "multi_agent_coordination.synthetic_review",
-  "profile": "implementation_control",
-  "public_safety": "synthetic_public",
-  "roles": ["coordinator", "worker", "reviewer", "gatekeeper"],
-  "reservations": [
-    {
-      "id": "reservation.review_scope",
-      "owner_role": "worker",
-      "scope": "synthetic review scope",
-      "allowed_actions": ["prepare review notes", "record evidence"],
-      "evidence_path": "synthetic/evidence/review-scope",
-      "proposal_path": "synthetic/proposals/review-scope"
-    }
-  ],
-  "locking_rules": [
-    "one active owner per bounded scope",
-    "canonical updates require coordinator review",
-    "conflicting proposals are resolved by coordinator decision"
-  ],
-  "conflict_resolution": "Pause conflicting reservations, compare evidence and accept only the coordinator-approved proposal.",
-  "evidence_refs": ["evidence.synthetic_risk_brief"],
-  "limitations": ["Synthetic coordination contract does not assign real people or systems."]
-}

package/examples/risk-and-coordination-minimal/results/risk-control-matrix.json

@@ -1,34 +0,0 @@
-{
-  "schema_version": "0.1.0",
-  "id": "risk_control_matrix.synthetic_review",
-  "profile": "implementation_control",
-  "public_safety": "synthetic_public",
-  "risks": [
-    {
-      "id": "risk.false_readiness",
-      "severity": "high",
-      "description": "Ready state is mistaken for completed work.",
-      "detection_signal": "state moves from ready_to_execute to approved without evidence.",
-      "prevention": "require launch and evidence gates before promotion.",
-      "gate_or_validator": "work_state_transition_validator",
-      "evidence_requirement": "state transition evidence and review note.",
-      "recovery_action": "return to last evidenced state.",
-      "escalation_rule": "escalate to coordinator when evidence is missing.",
-      "owner_role": "coordinator"
-    },
-    {
-      "id": "risk.write_collision",
-      "severity": "medium",
-      "description": "Two workers reserve the same bounded scope.",
-      "detection_signal": "duplicate active reservation for one scope.",
-      "prevention": "reservation registry and coordinator review.",
-      "gate_or_validator": "reservation_conflict_validator",
-      "evidence_requirement": "active reservation record.",
-      "recovery_action": "pause one reservation and merge proposals by coordinator decision.",
-      "escalation_rule": "escalate if scope ownership is unclear.",
-      "owner_role": "coordination owner"
-    }
-  ],
-  "evidence_refs": ["evidence.synthetic_risk_brief"],
-  "limitations": ["Synthetic matrix validates shape, not real operational coverage."]
-}

package/examples/self-service-onboarding/bootstrap-proposal/bootstrap-proposal.json

@@ -1,20 +0,0 @@
-{
-  "schema_version": "0.1.0",
-  "id": "bootstrap_proposal.self_service_fixture",
-  "mode": "bootstrap_suggest",
-  "target_dir": "examples/self-service-onboarding/no-graph",
-  "graph_presence": "missing",
-  "recommended_profile": "software_specification",
-  "recommended_template": "templates/software-project-starter",
-  "candidate_objects": [
-    {
-      "id": "project.detected_system",
-      "kind": "project",
-      "title": "Detected Project",
-      "summary": "Initial project object candidate for adopter review."
-    }
-  ],
-  "candidate_relations": [],
-  "canonical_write_allowed": false,
-  "next_safe_action": "mirai-graph init <target> --profile software_specification"
-}

package/examples/self-service-onboarding/existing-graph/README.md

@@ -1,4 +0,0 @@
-# Synthetic Project With Existing Mirai Graph
-
-This fixture already has a Mirai Graph package. `init` must not overwrite it
-unless `--force` is explicitly passed.

package/examples/self-service-onboarding/existing-graph/gates/results.json

@@ -1,11 +0,0 @@
-[
-  {
-    "id": "gate_result.synthetic_existing_graph.public_safety",
-    "gate_id": "gate.public_safety",
-    "target_id": "package.synthetic_existing_graph",
-    "verdict": "pass",
-    "summary": "Synthetic fixture contains no private material.",
-    "evidence": ["evidence.existing_fixture"],
-    "reviewer": "Mirai Graph self-service validator"
-  }
-]

package/examples/self-service-onboarding/existing-graph/graph/objects.json

@@ -1,11 +0,0 @@
-[
-  {
-    "id": "evidence.existing_fixture",
-    "kind": "evidence",
-    "title": "Existing Fixture Evidence",
-    "summary": "Synthetic evidence showing this fixture already has a graph.",
-    "readiness": "accepted",
-    "evidence": [],
-    "profile": "software_specification"
-  }
-]

package/examples/self-service-onboarding/existing-graph/graph/relations.json

@@ -1 +0,0 @@
-[]

package/examples/self-service-onboarding/existing-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_existing_graph",
-  "aliases": [],
-  "title": "Synthetic Existing 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": "Existing graph fixture for self-service init negative checks.",
-  "public_safety": "synthetic_public"
-}

package/examples/self-service-onboarding/no-graph/README.md

@@ -1,6 +0,0 @@
-# Synthetic Node Project Without Mirai Graph
-
-This fixture represents a small software project before Mirai Graph adoption.
-
-It intentionally has no `graph.json`, `graph/` or `gates/`
-artifacts.

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

@@ -1,6 +0,0 @@
-{
-  "name": "synthetic-no-graph-project",
-  "version": "0.1.0",
-  "private": true,
-  "description": "Synthetic project used to test Mirai Graph self-service detection."
-}

package/examples/self-service-onboarding/no-graph/src/index.js

@@ -1,3 +0,0 @@
-module.exports = function notifyAfterApproval() {
-  return "synthetic notification after approval";
-};

package/examples/self-service-onboarding/stale-graph/README.md

@@ -1,4 +0,0 @@
-# Synthetic Project With Incomplete Mirai Graph
-
-This fixture has a package manifest but no complete graph files. Detection
-should classify the graph as incomplete and recommend a safe bootstrap action.