mirai-graph 1.3.0 → 2.1.0

package/pilots/independent-implementation-005-organization-governance/README.md

@@ -1,42 +0,0 @@
-# Independent Implementation Pilot 005: Organization Governance
-
-Status: pilot fixture
-
-## Purpose
-
-This pilot tests whether Mirai Graph can model organization-level governance as a
-public-safe graph: mission, strategy, departments, programs, policies, decision
-rights, risks, controls, metrics, feedback and Kaizen.
-
-## Domain
-
-Synthetic organization governance program.
-
-No private company data, employee records, customer records, internal policy,
-handoff text, runtime trace or credential is used.
-
-## Governance Question
-
-Can a team model cross-department governance so that strategy, decision rights,
-evidence, risks and improvement proposals stay connected before work is
-promoted?
-
-## Files
-
-- `graph-seed.json`
-- `graph.json`
-- `graph/objects.json`
-- `graph/relations.json`
-- `gates/results.json`
-- `results/profile-conformance-result.json`
-- `reports/pilot-report.md`
-
-## Commands
-
-Run from repository root:
-
-```bash
-node packages/cli/validate-mirai-graph.js seed pilots/independent-implementation-005-organization-governance/graph-seed.json
-node packages/cli/validate-mirai-graph.js pilots/independent-implementation-005-organization-governance
-node packages/cli/validate-mirai-graph.js --markdown pilots/independent-implementation-005-organization-governance
-```

package/pilots/independent-implementation-005-organization-governance/gates/results.json

@@ -1,20 +0,0 @@
-[
-  {
-    "id": "gate_result.organization_governance.public_safety",
-    "gate_id": "public_safety_before_release",
-    "target_id": "package.organization_governance_pilot_005",
-    "verdict": "pass",
-    "summary": "The pilot uses synthetic public-safe organization-governance material only.",
-    "reviewed_at": "2026-06-03",
-    "evidence": ["evidence.governance_brief"]
-  },
-  {
-    "id": "gate_result.organization_governance.decision_rights",
-    "gate_id": "decision_right_before_policy_change",
-    "target_id": "policy.evidence_before_promotion",
-    "verdict": "pass_with_notes",
-    "summary": "The graph represents portfolio owner decision rights before cross-department promotion.",
-    "reviewed_at": "2026-06-03",
-    "evidence": ["evidence.governance_brief"]
-  }
-]

package/pilots/independent-implementation-005-organization-governance/graph/objects.json

@@ -1,137 +0,0 @@
-[
-  {
-    "id": "evidence.governance_brief",
-    "kind": "evidence",
-    "title": "Synthetic Governance Brief",
-    "summary": "Public-safe brief for a synthetic organization governance program.",
-    "readiness": "accepted",
-    "evidence": [],
-    "profile": "organization_governance"
-  },
-  {
-    "id": "organization.civic_platform",
-    "kind": "organization",
-    "title": "Civic Platform Organization",
-    "summary": "Synthetic organization used to test organization-scale Mirai Graph governance.",
-    "readiness": "review_ready",
-    "evidence": ["evidence.governance_brief"],
-    "profile": "organization_governance"
-  },
-  {
-    "id": "mission.trustworthy_service",
-    "kind": "mission",
-    "title": "Trustworthy Service",
-    "summary": "Provide dependable services while keeping decisions auditable.",
-    "readiness": "review_ready",
-    "evidence": ["evidence.governance_brief"],
-    "profile": "organization_governance"
-  },
-  {
-    "id": "strategy.evidence_led_operations",
-    "kind": "strategy",
-    "title": "Evidence-Led Operations",
-    "summary": "Promote operational changes only when evidence, decision rights and controls are recorded.",
-    "readiness": "review_ready",
-    "evidence": ["evidence.governance_brief"],
-    "profile": "organization_governance"
-  },
-  {
-    "id": "department.delivery",
-    "kind": "department",
-    "title": "Delivery Department",
-    "summary": "Department responsible for bounded implementation batches.",
-    "readiness": "review_ready",
-    "evidence": ["evidence.governance_brief"],
-    "profile": "organization_governance"
-  },
-  {
-    "id": "program.service_quality_program",
-    "kind": "program",
-    "title": "Service Quality Program",
-    "summary": "Cross-department program to improve service reliability and evidence coverage.",
-    "readiness": "review_ready",
-    "evidence": ["evidence.governance_brief"],
-    "profile": "organization_governance"
-  },
-  {
-    "id": "objective.reduce_false_progress",
-    "kind": "objective",
-    "title": "Reduce False Progress",
-    "summary": "Reduce claims that planned or ready work has already been executed.",
-    "readiness": "review_ready",
-    "evidence": ["evidence.governance_brief"],
-    "profile": "organization_governance"
-  },
-  {
-    "id": "policy.evidence_before_promotion",
-    "kind": "policy",
-    "title": "Evidence Before Promotion",
-    "summary": "A proposal cannot be promoted without evidence and decision-right review.",
-    "readiness": "accepted",
-    "evidence": ["evidence.governance_brief"],
-    "profile": "organization_governance"
-  },
-  {
-    "id": "decision_right.portfolio_owner",
-    "kind": "decision_right",
-    "title": "Portfolio Owner Decision Right",
-    "summary": "Portfolio owner approves changes that affect cross-department priorities.",
-    "readiness": "accepted",
-    "evidence": ["evidence.governance_brief"],
-    "profile": "organization_governance"
-  },
-  {
-    "id": "risk.policy_bypass",
-    "kind": "risk",
-    "title": "Policy Bypass",
-    "summary": "A team may treat generated context or feedback as authorization.",
-    "readiness": "review_ready",
-    "evidence": ["evidence.governance_brief"],
-    "profile": "organization_governance"
-  },
-  {
-    "id": "control.governance_review",
-    "kind": "control",
-    "title": "Governance Review",
-    "summary": "Review control checks decision rights, evidence and risk before promotion.",
-    "readiness": "accepted",
-    "evidence": ["evidence.governance_brief"],
-    "profile": "organization_governance"
-  },
-  {
-    "id": "metric.evidence_coverage",
-    "kind": "metric",
-    "title": "Evidence Coverage",
-    "summary": "Share of promoted decisions with linked evidence.",
-    "readiness": "review_ready",
-    "evidence": ["evidence.governance_brief"],
-    "profile": "organization_governance"
-  },
-  {
-    "id": "feedback.review_feedback",
-    "kind": "feedback",
-    "title": "Review Feedback",
-    "summary": "Review feedback can create a proposal but cannot update canonical graph state.",
-    "readiness": "draft",
-    "evidence": ["evidence.governance_brief"],
-    "profile": "organization_governance"
-  },
-  {
-    "id": "kaizen_item.tighten_promotion_gate",
-    "kind": "kaizen_item",
-    "title": "Tighten Promotion Gate",
-    "summary": "Improve the promotion gate when review finds missing evidence or decision rights.",
-    "readiness": "draft",
-    "evidence": ["evidence.governance_brief"],
-    "profile": "organization_governance"
-  },
-  {
-    "id": "governance_gate.promotion_review",
-    "kind": "governance_gate",
-    "title": "Promotion Review Gate",
-    "summary": "Gate before a proposal becomes an approved organizational change.",
-    "readiness": "accepted",
-    "evidence": ["evidence.governance_brief"],
-    "profile": "organization_governance"
-  }
-]

package/pilots/independent-implementation-005-organization-governance/graph/relations.json

@@ -1,110 +0,0 @@
-[
-  {
-    "id": "relation.organization.civic_platform.aligns_with.mission.trustworthy_service",
-    "type": "aligns_with",
-    "source": "organization.civic_platform",
-    "target": "mission.trustworthy_service",
-    "readiness": "review_ready",
-    "evidence": ["evidence.governance_brief"],
-    "profile": "organization_governance"
-  },
-  {
-    "id": "relation.strategy.evidence_led_operations.aligns_with.mission.trustworthy_service",
-    "type": "aligns_with",
-    "source": "strategy.evidence_led_operations",
-    "target": "mission.trustworthy_service",
-    "readiness": "review_ready",
-    "evidence": ["evidence.governance_brief"],
-    "profile": "organization_governance"
-  },
-  {
-    "id": "relation.department.delivery.belongs_to.organization.civic_platform",
-    "type": "belongs_to",
-    "source": "department.delivery",
-    "target": "organization.civic_platform",
-    "readiness": "review_ready",
-    "evidence": ["evidence.governance_brief"],
-    "profile": "organization_governance"
-  },
-  {
-    "id": "relation.program.service_quality_program.belongs_to.department.delivery",
-    "type": "belongs_to",
-    "source": "program.service_quality_program",
-    "target": "department.delivery",
-    "readiness": "review_ready",
-    "evidence": ["evidence.governance_brief"],
-    "profile": "organization_governance"
-  },
-  {
-    "id": "relation.objective.reduce_false_progress.supports.strategy.evidence_led_operations",
-    "type": "supports",
-    "source": "objective.reduce_false_progress",
-    "target": "strategy.evidence_led_operations",
-    "readiness": "review_ready",
-    "evidence": ["evidence.governance_brief"],
-    "profile": "organization_governance"
-  },
-  {
-    "id": "relation.policy.evidence_before_promotion.governs.program.service_quality_program",
-    "type": "governs",
-    "source": "policy.evidence_before_promotion",
-    "target": "program.service_quality_program",
-    "readiness": "accepted",
-    "evidence": ["evidence.governance_brief"],
-    "profile": "organization_governance"
-  },
-  {
-    "id": "relation.program.service_quality_program.requires_approval.decision_right.portfolio_owner",
-    "type": "requires_approval",
-    "source": "program.service_quality_program",
-    "target": "decision_right.portfolio_owner",
-    "readiness": "accepted",
-    "evidence": ["evidence.governance_brief"],
-    "profile": "organization_governance"
-  },
-  {
-    "id": "relation.control.governance_review.controls.risk.policy_bypass",
-    "type": "controls",
-    "source": "control.governance_review",
-    "target": "risk.policy_bypass",
-    "readiness": "accepted",
-    "evidence": ["evidence.governance_brief"],
-    "profile": "organization_governance"
-  },
-  {
-    "id": "relation.metric.evidence_coverage.measures.control.governance_review",
-    "type": "measures",
-    "source": "metric.evidence_coverage",
-    "target": "control.governance_review",
-    "readiness": "review_ready",
-    "evidence": ["evidence.governance_brief"],
-    "profile": "organization_governance"
-  },
-  {
-    "id": "relation.feedback.review_feedback.produces_feedback.program.service_quality_program",
-    "type": "produces_feedback",
-    "source": "feedback.review_feedback",
-    "target": "program.service_quality_program",
-    "readiness": "draft",
-    "evidence": ["evidence.governance_brief"],
-    "profile": "organization_governance"
-  },
-  {
-    "id": "relation.kaizen_item.tighten_promotion_gate.improves.control.governance_review",
-    "type": "improves",
-    "source": "kaizen_item.tighten_promotion_gate",
-    "target": "control.governance_review",
-    "readiness": "draft",
-    "evidence": ["evidence.governance_brief"],
-    "profile": "organization_governance"
-  },
-  {
-    "id": "relation.governance_gate.promotion_review.governs.policy.evidence_before_promotion",
-    "type": "governs",
-    "source": "governance_gate.promotion_review",
-    "target": "policy.evidence_before_promotion",
-    "readiness": "accepted",
-    "evidence": ["evidence.governance_brief"],
-    "profile": "organization_governance"
-  }
-]

package/pilots/independent-implementation-005-organization-governance/graph-seed.json

@@ -1,97 +0,0 @@
-{
-  "schema_version": "0.1.0",
-  "seed_id": "seed.organization_governance_pilot",
-  "target_graph_id": "graph.organization_governance_pilot",
-  "purpose": "Create a public-safe Mirai Graph package for organization governance.",
-  "target_profile": "profile.organization_governance",
-  "target_mode": "pilot",
-  "graph_dna": {
-    "purpose": "Keep mission, strategy, decision rights, risks, controls, metrics and improvement proposals connected.",
-    "evolution_vector": "Grow from a small governance pilot into a repeatable operating model for organization-scale control.",
-    "non_negotiable_principles": [
-      "The pilot must remain synthetic and public-safe.",
-      "Decision rights must be explicit before policy or portfolio changes.",
-      "Feedback and evidence may inform proposals but cannot automatically update canonical state."
-    ]
-  },
-  "source_boundaries": {
-    "allowed_sources": [
-      "synthetic organization governance brief",
-      "public Mirai Graph organization-governance profile",
-      "public Mirai Graph governance standard docs"
-    ],
-    "excluded_sources": [
-      "private company data",
-      "employee records",
-      "customer records",
-      "internal policy text",
-      "private workflow traces",
-      "secrets or credentials"
-    ],
-    "canonical_write_allowed": false
-  },
-  "growth_rules": {
-    "allowed_object_families": [
-      "organization",
-      "mission",
-      "strategy",
-      "portfolio",
-      "department",
-      "program",
-      "objective",
-      "policy",
-      "decision_right",
-      "governance_gate",
-      "role",
-      "capability",
-      "risk",
-      "control",
-      "metric",
-      "feedback",
-      "kaizen_item",
-      "evidence"
-    ],
-    "allowed_relation_families": [
-      "aligns_with",
-      "owns",
-      "belongs_to",
-      "governs",
-      "requires_approval",
-      "controls",
-      "mitigates",
-      "measures",
-      "supports",
-      "depends_on",
-      "blocks",
-      "escalates_to",
-      "produces_feedback",
-      "improves",
-      "evidences",
-      "related_to"
-    ],
-    "max_initial_objects": 20,
-    "depth_mode": "standard"
-  },
-  "review_gates": [
-    "strategy_alignment_before_portfolio_change",
-    "decision_right_before_policy_change",
-    "risk_control_before_cross_department_action",
-    "evidence_before_governance_decision",
-    "kaizen_before_process_promotion",
-    "no_generated_context_as_authorization",
-    "no_feedback_as_automatic_update"
-  ],
-  "generated_views": [
-    "strategy_alignment_view",
-    "decision_rights_view",
-    "risk_control_view",
-    "metric_dashboard_view",
-    "kaizen_queue_view"
-  ],
-  "stop_conditions": [
-    "private_company_data_requested",
-    "decision_right_missing_for_policy_change",
-    "feedback_treated_as_automatic_update",
-    "secret_or_credential_detected"
-  ]
-}

package/pilots/independent-implementation-005-organization-governance/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.organization_governance_pilot_005",
-  "aliases": [],
-  "title": "Organization Governance Pilot 005",
-  "scope": "package",
-  "kind": "graph_package",
-  "owner": "mirai-graph",
-  "profiles": [
-    "organization_governance"
-  ],
-  "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 independent implementation pilot for organization-level governance.",
-  "license": "CC-BY-4.0",
-  "public_safety": "synthetic_public"
-}

package/pilots/independent-implementation-005-organization-governance/reports/pilot-report.md

@@ -1,47 +0,0 @@
-# Pilot Report: Organization Governance
-
-Status: public-safe alpha pilot
-
-## Question
-
-Can Mirai Graph model organization-level governance with explicit strategy
-alignment, decision rights, controls, metrics, feedback and Kaizen?
-
-## Setup
-
-The pilot uses a synthetic organization governance program. The graph connects:
-
-- organization and mission;
-- strategy and objective;
-- department and program;
-- policy and decision right;
-- risk and control;
-- metric and governance review;
-- feedback and Kaizen improvement queue.
-
-## Result
-
-The package validates against the public `organization_governance` profile. The
-graph shows how organization governance can make promotion gates, decision
-rights and feedback boundaries explicit.
-
-## Evidence Boundary
-
-This pilot demonstrates public profile applicability and validation shape. It
-does not claim organization performance improvement, legal compliance,
-production governance safety or external validity.
-
-## Reproducibility
-
-```bash
-node packages/cli/validate-mirai-graph.js seed pilots/independent-implementation-005-organization-governance/graph-seed.json
-node packages/cli/validate-mirai-graph.js pilots/independent-implementation-005-organization-governance
-node packages/cli/validate-mirai-graph.js --markdown pilots/independent-implementation-005-organization-governance
-```
-
-## Limitations
-
-- The scenario is synthetic.
-- No private organization materials are included.
-- The graph models governance structure, not jurisdiction-specific compliance.
-- Feedback and evidence remain bounded and do not authorize canonical updates.

package/pilots/independent-implementation-005-organization-governance/results/profile-conformance-result.json

@@ -1,29 +0,0 @@
-{
-  "schema_version": "0.1.0",
-  "result_id": "profile_conformance.package.organization_governance_pilot_005",
-  "checked_at": "2026-06-03",
-  "fixture": "pilots/independent-implementation-005-organization-governance/",
-  "package_id": "package.organization_governance_pilot_005",
-  "profile": "organization_governance",
-  "conformance_level": "level_1",
-  "validator": "packages/cli/validate-mirai-graph.js",
-  "command": "node packages/cli/validate-mirai-graph.js pilots/independent-implementation-005-organization-governance",
-  "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",
-    "organization_governance object-kind conformance",
-    "organization_governance relation-type conformance",
-    "decision-right and feedback boundary represented"
-  ],
-  "claim_supported": "The package follows the declared Mirai Graph profile shape checked by the current validator.",
-  "limitations": [
-    "The pilot is synthetic and does not prove organization performance.",
-    "The profile models governance structure, not local legal, HR or operational policy."
-  ]
-}

package/playground/README.md

@@ -1,78 +0,0 @@
-# Mirai Graph Playground
-
-Status: 1.0 release-candidate deterministic runnable demo
-
-This directory is a playground package for public-safe Mirai Graph demos. The
-current 1.0 release-candidate playground is CLI-based and deterministic:
-runnable examples live in `examples/`, `benchmarks/` and `pilots/`, and the
-generated report is stored as `playground/demo-report.md`.
-
-## Quick Runs
-
-Validate a minimal graph package:
-
-```bash
-npm run validate:minimal
-```
-
-Preview a graph seed:
-
-```bash
-npm run seed:preview
-```
-
-Generate a synthetic context pack:
-
-```bash
-npm run context:generate
-```
-
-Generate the end-to-end playground report:
-
-```bash
-npm run playground:demo
-npm run playground:report
-```
-
-Validate implementation-control and process-control examples:
-
-```bash
-npm run validate:implementation-control
-npm run validate:implementation-control-cycles
-npm run validate:launch-record
-npm run validate:process-transition
-npm run validate:process-control
-```
-
-Run negative fixtures:
-
-```bash
-npm run test:negative
-npm run test:process-transition-negative
-```
-
-Run the full release-candidate suite:
-
-```bash
-npm test
-```
-
-## Demo Paths
-
-- `examples/minimal-graph/`
-- `examples/graph-seed-minimal/`
-- `examples/implementation-control-minimal/`
-- `examples/implementation-control-cycles/`
-- `examples/launch-record-minimal/`
-- `examples/process-transition-minimal/`
-- `examples/process-control-contract-minimal/`
-- `benchmarks/synthetic-context-reduction-v0/`
-- `benchmarks/synthetic-context-reduction-v0/results/baseline-comparison-result.json`
-- `playground/demo-report.md`
-
-## Future Work
-
-A hosted or interactive playground can be added later. Until then, this index
-keeps the public README honest: Mirai Graph has a deterministic local report with
-transition explanation and baseline comparison, but not yet a separate
-interactive application.