mirai-graph 1.3.0 → 2.1.0

package/pilots/independent-implementation-001-conference-planning/README.md

@@ -1,40 +0,0 @@
-# Independent Implementation Pilot 001: Conference Planning
-
-Status: pilot fixture
-
-## Purpose
-
-This pilot tests whether a valid Mirai Graph package can be created using only
-the public repository materials.
-
-## Domain
-
-Synthetic conference planning workflow.
-
-No private company, customer, employee or internal project material is used.
-
-## Research Question
-
-Can a developer create a valid Level 1 Mirai Graph package for a small workflow
-using only public Mirai Graph docs, schemas and examples?
-
-## Files
-
-- `graph-seed.json`
-- `graph.json`
-- `graph/objects.json`
-- `graph/relations.json`
-- `gates/results.json`
-- `results/`
-- `reports/pilot-report.md`
-
-## Commands
-
-Run from repository root:
-
-```bash
-node packages/cli/validate-mirai-graph.js seed pilots/independent-implementation-001-conference-planning/graph-seed.json
-node packages/cli/validate-mirai-graph.js pilots/independent-implementation-001-conference-planning
-node packages/cli/readiness-score.js pilots/independent-implementation-001-conference-planning --target-mode pilot
-node packages/cli/context-pack.js pilots/independent-implementation-001-conference-planning --task-id task.prepare_speaker_schedule
-```

package/pilots/independent-implementation-001-conference-planning/gates/results.json

@@ -1,12 +0,0 @@
-[
-  {
-    "id": "gate_result.conference_planning.public_safety",
-    "gate_id": "gate.public_safety",
-    "target_id": "package.conference_planning_pilot_001",
-    "verdict": "pass",
-    "summary": "The pilot uses synthetic public-safe conference planning material only.",
-    "evidence": ["source.conference_brief"],
-    "reviewed_at": "2026-05-28",
-    "reviewer": "Mirai Graph maintainers"
-  }
-]

package/pilots/independent-implementation-001-conference-planning/graph/objects.json

@@ -1,74 +0,0 @@
-[
-  {
-    "id": "source.conference_brief",
-    "kind": "evidence",
-    "title": "Synthetic conference brief",
-    "summary": "A public-safe synthetic brief for a one-day community conference.",
-    "readiness": "accepted",
-    "evidence": [],
-    "profile": "project_management"
-  },
-  {
-    "id": "system.community_conference",
-    "kind": "system",
-    "title": "Community Conference",
-    "summary": "A synthetic one-day conference planning workflow.",
-    "readiness": "review_ready",
-    "evidence": ["source.conference_brief"],
-    "profile": "project_management"
-  },
-  {
-    "id": "goal.publish_reliable_schedule",
-    "kind": "goal",
-    "title": "Publish reliable schedule",
-    "summary": "Prepare and publish a reliable speaker schedule for the conference.",
-    "readiness": "review_ready",
-    "evidence": ["source.conference_brief"],
-    "profile": "project_management"
-  },
-  {
-    "id": "task.collect_session_proposals",
-    "kind": "task",
-    "title": "Collect session proposals",
-    "summary": "Collect proposed talks and workshops before schedule planning.",
-    "readiness": "review_ready",
-    "evidence": ["source.conference_brief"],
-    "profile": "project_management"
-  },
-  {
-    "id": "task.confirm_room_capacity",
-    "kind": "task",
-    "title": "Confirm room capacity",
-    "summary": "Confirm available room capacity before assigning sessions.",
-    "readiness": "review_ready",
-    "evidence": ["source.conference_brief"],
-    "profile": "project_management"
-  },
-  {
-    "id": "decision.schedule_publish_gate",
-    "kind": "decision",
-    "title": "Schedule publish gate",
-    "summary": "The schedule may be published only after owner review.",
-    "readiness": "draft",
-    "evidence": ["source.conference_brief"],
-    "profile": "project_management"
-  },
-  {
-    "id": "risk.session_room_mismatch",
-    "kind": "risk",
-    "title": "Session room mismatch",
-    "summary": "A popular session may be assigned to a room that is too small.",
-    "readiness": "review_ready",
-    "evidence": ["source.conference_brief"],
-    "profile": "project_management"
-  },
-  {
-    "id": "gate.owner_schedule_approval",
-    "kind": "governance_gate",
-    "title": "Owner schedule approval",
-    "summary": "Owner approval is required before schedule publication.",
-    "readiness": "accepted",
-    "evidence": ["source.conference_brief"],
-    "profile": "project_management"
-  }
-]

package/pilots/independent-implementation-001-conference-planning/graph/relations.json

@@ -1,56 +0,0 @@
-[
-  {
-    "id": "relation.system.community_conference.supports.goal.publish_reliable_schedule",
-    "type": "supports",
-    "source": "system.community_conference",
-    "target": "goal.publish_reliable_schedule",
-    "readiness": "review_ready",
-    "evidence": ["source.conference_brief"],
-    "profile": "project_management"
-  },
-  {
-    "id": "relation.task.collect_session_proposals.supports.goal.publish_reliable_schedule",
-    "type": "supports",
-    "source": "task.collect_session_proposals",
-    "target": "goal.publish_reliable_schedule",
-    "readiness": "review_ready",
-    "evidence": ["source.conference_brief"],
-    "profile": "project_management"
-  },
-  {
-    "id": "relation.task.confirm_room_capacity.blocks.risk.session_room_mismatch",
-    "type": "blocks",
-    "source": "task.confirm_room_capacity",
-    "target": "risk.session_room_mismatch",
-    "readiness": "review_ready",
-    "evidence": ["source.conference_brief"],
-    "profile": "project_management"
-  },
-  {
-    "id": "relation.risk.session_room_mismatch.blocks.goal.publish_reliable_schedule",
-    "type": "blocks",
-    "source": "risk.session_room_mismatch",
-    "target": "goal.publish_reliable_schedule",
-    "readiness": "review_ready",
-    "evidence": ["source.conference_brief"],
-    "profile": "project_management"
-  },
-  {
-    "id": "relation.gate.owner_schedule_approval.governs.decision.schedule_publish_gate",
-    "type": "governs",
-    "source": "gate.owner_schedule_approval",
-    "target": "decision.schedule_publish_gate",
-    "readiness": "accepted",
-    "evidence": ["source.conference_brief"],
-    "profile": "project_management"
-  },
-  {
-    "id": "relation.decision.schedule_publish_gate.depends_on.task.confirm_room_capacity",
-    "type": "depends_on",
-    "source": "decision.schedule_publish_gate",
-    "target": "task.confirm_room_capacity",
-    "readiness": "draft",
-    "evidence": ["source.conference_brief"],
-    "profile": "project_management"
-  }
-]

package/pilots/independent-implementation-001-conference-planning/graph-seed.json

@@ -1,65 +0,0 @@
-{
-  "schema_version": "0.1.0",
-  "seed_id": "seed.conference_planning",
-  "target_graph_id": "graph.conference_planning",
-  "purpose": "Create a Mirai Graph package for managing a small public conference planning workflow.",
-  "target_profile": "profile.project_management",
-  "target_mode": "pilot",
-  "graph_dna": {
-    "purpose": "Keep conference goals, planning tasks, decisions, risks and governance checks connected.",
-    "evolution_vector": "Grow from a small planning map into a reviewed conference operations graph.",
-    "non_negotiable_principles": [
-      "The package must remain synthetic and public-safe.",
-      "Schedule decisions require owner review before they are treated as accepted."
-    ]
-  },
-  "source_boundaries": {
-    "allowed_sources": [
-      "synthetic conference planning brief",
-      "synthetic organizer notes"
-    ],
-    "excluded_sources": [
-      "real attendee data",
-      "private sponsor contracts",
-      "personal speaker contact details"
-    ],
-    "canonical_write_allowed": false
-  },
-  "growth_rules": {
-    "allowed_object_families": [
-      "system",
-      "goal",
-      "task",
-      "decision",
-      "risk",
-      "evidence",
-      "governance_gate"
-    ],
-    "allowed_relation_families": [
-      "depends_on",
-      "blocks",
-      "supports",
-      "evidences",
-      "governs",
-      "belongs_to"
-    ],
-    "max_initial_objects": 12,
-    "depth_mode": "light"
-  },
-  "review_gates": [
-    "human_review_before_canonical_write",
-    "public_safety_before_release",
-    "owner_approval_before_schedule_publish"
-  ],
-  "generated_views": [
-    "seed_summary",
-    "candidate_object_list",
-    "risk_view",
-    "next_action_view"
-  ],
-  "stop_conditions": [
-    "real_personal_data_requested",
-    "schedule_publish_requested_before_owner_approval",
-    "candidate_count_exceeds_budget"
-  ]
-}

package/pilots/independent-implementation-001-conference-planning/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.conference_planning_pilot_001",
-  "aliases": [],
-  "title": "Conference Planning Pilot 001",
-  "scope": "package",
-  "kind": "graph_package",
-  "owner": "mirai-graph",
-  "profiles": [
-    "project_management"
-  ],
-  "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 a conference planning workflow.",
-  "license": "CC-BY-4.0",
-  "public_safety": "synthetic_public"
-}

package/pilots/independent-implementation-001-conference-planning/reports/pilot-report.md

@@ -1,120 +0,0 @@
-# Pilot Report: Independent Implementation 001
-
-Date: 2026-05-28
-
-Status: `pass_with_notes`
-
-## Purpose
-
-Test whether a valid Mirai Graph Level 1 package can be created using only the
-public repository materials.
-
-## Domain
-
-Synthetic conference planning workflow.
-
-No private company, customer, employee or internal project material was used.
-
-## Research Question
-
-Can a developer create a valid Level 1 Mirai Graph package for a small workflow
-using only public Mirai Graph docs, schemas and examples?
-
-## Result
-
-Verdict: `pass_with_notes`
-
-The pilot produced:
-
-- valid graph seed;
-- valid Mirai Graph package;
-- valid object and relation files;
-- public-safety gate result;
-- generated graph embryo preview;
-- generated context pack;
-- readiness score.
-
-## Evidence
-
-Validation artifacts:
-
-- `results/seed-validation.json`
-- `results/package-validation.json`
-- `results/graph-embryo.json`
-- `results/context-pack.json`
-- `results/readiness-score.json`
-
-Package summary:
-
-- objects: `8`;
-- relations: `6`;
-- evidence objects: `1`;
-- accepted objects: `2`;
-- gate results: `1`;
-- target mode: `pilot`;
-- readiness score: `69`;
-- readiness band: `G3_pilot_ready`.
-
-## What Worked
-
-- The public examples were enough to create a new package shape.
-- The seed schema and validator made source boundaries and review gates
-  explicit.
-- The package validator caught structural issues during drafting.
-- The context-pack generator produced a traceable context package.
-- Readiness scoring correctly capped the result because evidence is synthetic
-  and benchmark evidence is missing for this pilot.
-
-## Gaps Found
-
-### Standard Gap
-
-The project-management profile is still thin. It validates basic fields but
-does not yet explain:
-
-- milestone modeling;
-- owner/stakeholder modeling;
-- task status vs readiness;
-- schedule publication gates;
-- action records.
-
-### Tooling Gap
-
-The context-pack generator now uses token matching and one-hop relation
-expansion, but it does not yet score semantic completeness or explain why each
-selected object is necessary.
-
-### Research Gap
-
-The pilot proves package creation and validation, not practical improvement.
-There is no current-mode baseline and no task-performance comparison.
-
-### Documentation Gap
-
-The adoption guide is enough for a small package, but it should include a
-worked example from seed to validated package.
-
-## Interpretation
-
-This pilot supports a limited claim:
-
-```text
-A valid Mirai Graph Level 1 package can be created from public repository
-materials for a small synthetic workflow.
-```
-
-It does not support claims about:
-
-- real-world productivity;
-- semantic completeness;
-- external validity;
-- runtime safety;
-- universal applicability.
-
-## Recommended Next Actions
-
-1. Add a worked tutorial from graph seed to validated package.
-2. Improve context-pack relevance scoring and selection explanations.
-3. Add project-management profile documentation.
-4. Add action/gate result examples.
-5. Run a second pilot on a software-specification workflow.

package/pilots/independent-implementation-001-conference-planning/results/context-pack.json

@@ -1,35 +0,0 @@
-{
-  "id": "context_pack.task_prepare_speaker_schedule",
-  "task_id": "task.prepare_speaker_schedule",
-  "source_graph": "package.conference_planning_pilot_001",
-  "generated_at": "2026-05-28T18:13:04.949Z",
-  "included_objects": [
-    "source.conference_brief",
-    "system.community_conference",
-    "goal.publish_reliable_schedule",
-    "task.collect_session_proposals",
-    "task.confirm_room_capacity",
-    "decision.schedule_publish_gate",
-    "risk.session_room_mismatch",
-    "gate.owner_schedule_approval"
-  ],
-  "included_relations": [
-    "relation.system.community_conference.supports.goal.publish_reliable_schedule",
-    "relation.task.collect_session_proposals.supports.goal.publish_reliable_schedule",
-    "relation.task.confirm_room_capacity.blocks.risk.session_room_mismatch",
-    "relation.risk.session_room_mismatch.blocks.goal.publish_reliable_schedule",
-    "relation.gate.owner_schedule_approval.governs.decision.schedule_publish_gate",
-    "relation.decision.schedule_publish_gate.depends_on.task.confirm_room_capacity"
-  ],
-  "evidence": [
-    "source.conference_brief"
-  ],
-  "assumptions": [
-    "Alpha generator uses token matching plus one-hop relation expansion."
-  ],
-  "omissions": [],
-  "limitations": [
-    "Generated context pack is not canonical state.",
-    "This alpha generator does not prove semantic completeness."
-  ]
-}

package/pilots/independent-implementation-001-conference-planning/results/graph-embryo.json

@@ -1,81 +0,0 @@
-{
-  "schema_version": "0.1.0",
-  "embryo_id": "embryo.conference_planning",
-  "seed_id": "seed.conference_planning",
-  "generated_at": "2026-05-28T17:54:11.318Z",
-  "candidate_objects": [
-    {
-      "id": "system.candidate_1",
-      "kind": "system",
-      "title": "Candidate System",
-      "summary": "Candidate system object proposed from seed seed.conference_planning.",
-      "readiness": "draft",
-      "evidence": [],
-      "profile": "project_management"
-    },
-    {
-      "id": "goal.candidate_2",
-      "kind": "goal",
-      "title": "Candidate Goal",
-      "summary": "Candidate goal object proposed from seed seed.conference_planning.",
-      "readiness": "draft",
-      "evidence": [],
-      "profile": "project_management"
-    },
-    {
-      "id": "task.candidate_3",
-      "kind": "task",
-      "title": "Candidate Task",
-      "summary": "Candidate task object proposed from seed seed.conference_planning.",
-      "readiness": "draft",
-      "evidence": [],
-      "profile": "project_management"
-    },
-    {
-      "id": "decision.candidate_4",
-      "kind": "decision",
-      "title": "Candidate Decision",
-      "summary": "Candidate decision object proposed from seed seed.conference_planning.",
-      "readiness": "draft",
-      "evidence": [],
-      "profile": "project_management"
-    },
-    {
-      "id": "risk.candidate_5",
-      "kind": "risk",
-      "title": "Candidate Risk",
-      "summary": "Candidate risk object proposed from seed seed.conference_planning.",
-      "readiness": "draft",
-      "evidence": [],
-      "profile": "project_management"
-    },
-    {
-      "id": "evidence.candidate_6",
-      "kind": "evidence",
-      "title": "Candidate Evidence",
-      "summary": "Candidate evidence object proposed from seed seed.conference_planning.",
-      "readiness": "draft",
-      "evidence": [],
-      "profile": "project_management"
-    },
-    {
-      "id": "governance_gate.candidate_7",
-      "kind": "governance_gate",
-      "title": "Candidate Governance Gate",
-      "summary": "Candidate governance_gate object proposed from seed seed.conference_planning.",
-      "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/pilots/independent-implementation-001-conference-planning/results/package-validation.json

@@ -1,7 +0,0 @@
-{
-  "mode": "package",
-  "target": "pilots/independent-implementation-001-conference-planning",
-  "valid": true,
-  "errors": [],
-  "warnings": []
-}

package/pilots/independent-implementation-001-conference-planning/results/profile-conformance-result.json

@@ -1,28 +0,0 @@
-{
-  "schema_version": "0.1.0",
-  "result_id": "profile_conformance.package.conference_planning_pilot_001",
-  "checked_at": "2026-05-29",
-  "fixture": "pilots/independent-implementation-001-conference-planning/",
-  "package_id": "package.conference_planning_pilot_001",
-  "profile": "project_management",
-  "conformance_level": "level_1",
-  "validator": "packages/cli/validate-mirai-graph.js",
-  "command": "node packages/cli/validate-mirai-graph.js pilots/independent-implementation-001-conference-planning",
-  "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",
-    "project_management object-kind conformance",
-    "project_management 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, usefulness or downstream task performance.",
-    "The pilot package is synthetic public-safe evidence."
-  ]
-}

package/pilots/independent-implementation-001-conference-planning/results/readiness-score.json

@@ -1,26 +0,0 @@
-{
-  "schema_version": "0.1.0",
-  "target_mode": "pilot",
-  "score": 69,
-  "band": "G3_pilot_ready",
-  "evidence": [
-    "package manifest exists",
-    "objects exist: 8",
-    "relations exist: 6",
-    "evidence objects exist: 1",
-    "accepted objects exist: 2",
-    "gate results exist: 1"
-  ],
-  "blockers": [],
-  "caps": [
-    {
-      "reason": "no benchmark evidence for pilot/runtime target",
-      "max_score": 69
-    },
-    {
-      "reason": "synthetic-only evidence cannot exceed pilot-ready navigation score",
-      "max_score": 69
-    }
-  ],
-  "note": "Release-candidate readiness score; use as navigation, not approval."
-}

package/pilots/independent-implementation-001-conference-planning/results/seed-validation.json

@@ -1,7 +0,0 @@
-{
-  "mode": "seed",
-  "target": "pilots/independent-implementation-001-conference-planning/graph-seed.json",
-  "valid": true,
-  "errors": [],
-  "warnings": []
-}

package/pilots/independent-implementation-002-software-specification/README.md

@@ -1,40 +0,0 @@
-# Independent Implementation Pilot 002: Software Specification
-
-Status: pilot fixture
-
-## Purpose
-
-This pilot tests whether a valid Mirai Graph package can be created for a small
-software specification workflow using only the public repository materials.
-
-## Domain
-
-Synthetic team notification API workflow.
-
-No private company, customer, employee or internal project material is used.
-
-## Research Question
-
-Can a developer create a valid Level 1 Mirai Graph package for a small software
-specification using only public Mirai Graph docs, schemas and examples?
-
-## Files
-
-- `graph-seed.json`
-- `graph.json`
-- `graph/objects.json`
-- `graph/relations.json`
-- `gates/results.json`
-- `results/`
-- `reports/pilot-report.md`
-
-## Commands
-
-Run from repository root:
-
-```bash
-node packages/cli/validate-mirai-graph.js seed pilots/independent-implementation-002-software-specification/graph-seed.json
-node packages/cli/validate-mirai-graph.js pilots/independent-implementation-002-software-specification
-node packages/cli/readiness-score.js pilots/independent-implementation-002-software-specification --target-mode pilot
-node packages/cli/context-pack.js pilots/independent-implementation-002-software-specification --task-id task.implement_retry_policy
-```

package/pilots/independent-implementation-002-software-specification/gates/results.json

@@ -1,22 +0,0 @@
-[
-  {
-    "id": "gate_result.notification_api.public_safety",
-    "gate_id": "gate.public_safety",
-    "target_id": "package.notification_api_spec_pilot_002",
-    "verdict": "pass",
-    "summary": "The pilot uses synthetic public-safe software specification material only.",
-    "evidence": ["source.notification_api_brief"],
-    "reviewed_at": "2026-05-28",
-    "reviewer": "Mirai Graph maintainers"
-  },
-  {
-    "id": "gate_result.notification_api.requirement_traceability",
-    "gate_id": "gate.requirement_traceability",
-    "target_id": "task.implement_retry_policy",
-    "verdict": "pass_with_notes",
-    "summary": "The implementation task traces to a feature and requirement, but acceptance criteria are not modeled yet.",
-    "evidence": ["source.notification_api_brief"],
-    "reviewed_at": "2026-05-28",
-    "reviewer": "Mirai Graph maintainers"
-  }
-]