mirai-graph 1.0.0-rc.1

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

@@ -0,0 +1,120 @@
+# 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

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

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

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

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

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

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

@@ -0,0 +1,40 @@
+# 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`
+- `mirai-graph-package.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

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

package/pilots/independent-implementation-002-software-specification/graph/objects.json

@@ -0,0 +1,101 @@
+[
+  {
+    "id": "source.notification_api_brief",
+    "kind": "evidence",
+    "title": "Synthetic notification API brief",
+    "summary": "A public-safe synthetic brief for a team notification API.",
+    "readiness": "accepted",
+    "evidence": [],
+    "profile": "software_specification"
+  },
+  {
+    "id": "package.team_notification_api",
+    "kind": "package",
+    "title": "Team Notification API",
+    "summary": "A small synthetic API package for sending team notifications.",
+    "readiness": "review_ready",
+    "evidence": ["source.notification_api_brief"],
+    "profile": "software_specification"
+  },
+  {
+    "id": "requirement.notify_after_event",
+    "kind": "requirement",
+    "title": "Notify after event",
+    "summary": "The system must send a notification after an approved event is recorded.",
+    "readiness": "review_ready",
+    "evidence": ["source.notification_api_brief"],
+    "profile": "software_specification"
+  },
+  {
+    "id": "feature.webhook_delivery",
+    "kind": "feature",
+    "title": "Webhook delivery",
+    "summary": "Deliver notifications to a configured webhook endpoint.",
+    "readiness": "review_ready",
+    "evidence": ["source.notification_api_brief"],
+    "profile": "software_specification"
+  },
+  {
+    "id": "feature.retry_policy",
+    "kind": "feature",
+    "title": "Retry policy",
+    "summary": "Retry failed webhook deliveries with a bounded retry policy.",
+    "readiness": "review_ready",
+    "evidence": ["source.notification_api_brief"],
+    "profile": "software_specification"
+  },
+  {
+    "id": "component.delivery_worker",
+    "kind": "component",
+    "title": "Delivery worker",
+    "summary": "Background worker responsible for webhook delivery attempts.",
+    "readiness": "draft",
+    "evidence": ["source.notification_api_brief"],
+    "profile": "software_specification"
+  },
+  {
+    "id": "constraint.no_secret_logging",
+    "kind": "constraint",
+    "title": "No secret logging",
+    "summary": "Webhook credentials and request secrets must not be logged.",
+    "readiness": "accepted",
+    "evidence": ["source.notification_api_brief"],
+    "profile": "software_specification"
+  },
+  {
+    "id": "risk.duplicate_delivery",
+    "kind": "risk",
+    "title": "Duplicate delivery",
+    "summary": "Retries may deliver the same notification more than once.",
+    "readiness": "review_ready",
+    "evidence": ["source.notification_api_brief"],
+    "profile": "software_specification"
+  },
+  {
+    "id": "risk.credential_leak",
+    "kind": "risk",
+    "title": "Credential leak",
+    "summary": "Webhook credentials may leak through logs or error messages.",
+    "readiness": "review_ready",
+    "evidence": ["source.notification_api_brief"],
+    "profile": "software_specification"
+  },
+  {
+    "id": "decision.idempotency_key_required",
+    "kind": "decision",
+    "title": "Idempotency key required",
+    "summary": "Delivery requests should include an idempotency key to reduce duplicate side effects.",
+    "readiness": "draft",
+    "evidence": ["source.notification_api_brief"],
+    "profile": "software_specification"
+  },
+  {
+    "id": "task.implement_retry_policy",
+    "kind": "task",
+    "title": "Implement retry policy",
+    "summary": "Implement bounded retries in the delivery worker.",
+    "readiness": "review_ready",
+    "evidence": ["source.notification_api_brief"],
+    "profile": "software_specification"
+  }
+]

package/pilots/independent-implementation-002-software-specification/graph/relations.json

@@ -0,0 +1,92 @@
+[
+  {
+    "id": "relation.package.team_notification_api.implements.requirement.notify_after_event",
+    "type": "implements",
+    "source": "package.team_notification_api",
+    "target": "requirement.notify_after_event",
+    "readiness": "review_ready",
+    "evidence": ["source.notification_api_brief"],
+    "profile": "software_specification"
+  },
+  {
+    "id": "relation.feature.webhook_delivery.implements.requirement.notify_after_event",
+    "type": "implements",
+    "source": "feature.webhook_delivery",
+    "target": "requirement.notify_after_event",
+    "readiness": "review_ready",
+    "evidence": ["source.notification_api_brief"],
+    "profile": "software_specification"
+  },
+  {
+    "id": "relation.feature.retry_policy.depends_on.feature.webhook_delivery",
+    "type": "depends_on",
+    "source": "feature.retry_policy",
+    "target": "feature.webhook_delivery",
+    "readiness": "review_ready",
+    "evidence": ["source.notification_api_brief"],
+    "profile": "software_specification"
+  },
+  {
+    "id": "relation.component.delivery_worker.implements.feature.retry_policy",
+    "type": "implements",
+    "source": "component.delivery_worker",
+    "target": "feature.retry_policy",
+    "readiness": "draft",
+    "evidence": ["source.notification_api_brief"],
+    "profile": "software_specification"
+  },
+  {
+    "id": "relation.constraint.no_secret_logging.blocks.risk.credential_leak",
+    "type": "blocks",
+    "source": "constraint.no_secret_logging",
+    "target": "risk.credential_leak",
+    "readiness": "review_ready",
+    "evidence": ["source.notification_api_brief"],
+    "profile": "software_specification"
+  },
+  {
+    "id": "relation.feature.retry_policy.related_to.risk.duplicate_delivery",
+    "type": "related_to",
+    "source": "feature.retry_policy",
+    "target": "risk.duplicate_delivery",
+    "readiness": "review_ready",
+    "evidence": ["source.notification_api_brief"],
+    "profile": "software_specification"
+  },
+  {
+    "id": "relation.decision.idempotency_key_required.blocks.risk.duplicate_delivery",
+    "type": "blocks",
+    "source": "decision.idempotency_key_required",
+    "target": "risk.duplicate_delivery",
+    "readiness": "draft",
+    "evidence": ["source.notification_api_brief"],
+    "profile": "software_specification"
+  },
+  {
+    "id": "relation.task.implement_retry_policy.implements.feature.retry_policy",
+    "type": "implements",
+    "source": "task.implement_retry_policy",
+    "target": "feature.retry_policy",
+    "readiness": "review_ready",
+    "evidence": ["source.notification_api_brief"],
+    "profile": "software_specification"
+  },
+  {
+    "id": "relation.task.implement_retry_policy.depends_on.requirement.notify_after_event",
+    "type": "depends_on",
+    "source": "task.implement_retry_policy",
+    "target": "requirement.notify_after_event",
+    "readiness": "review_ready",
+    "evidence": ["source.notification_api_brief"],
+    "profile": "software_specification"
+  },
+  {
+    "id": "relation.task.implement_retry_policy.depends_on.decision.idempotency_key_required",
+    "type": "depends_on",
+    "source": "task.implement_retry_policy",
+    "target": "decision.idempotency_key_required",
+    "readiness": "draft",
+    "evidence": ["source.notification_api_brief"],
+    "profile": "software_specification"
+  }
+]

package/pilots/independent-implementation-002-software-specification/graph-seed.json

@@ -0,0 +1,72 @@
+{
+  "schema_version": "0.1.0",
+  "seed_id": "seed.notification_api_spec",
+  "target_graph_id": "graph.notification_api_spec",
+  "purpose": "Create a Mirai Graph package for a small software specification workflow.",
+  "target_profile": "profile.software_specification",
+  "target_mode": "pilot",
+  "graph_dna": {
+    "purpose": "Keep package scope, features, requirements, constraints, risks and implementation tasks connected.",
+    "evolution_vector": "Grow from a small API specification map into a reviewed software delivery graph.",
+    "non_negotiable_principles": [
+      "The package must remain synthetic and public-safe.",
+      "Implementation tasks must remain traceable to requirements and constraints.",
+      "Public release claims require explicit public-safety review."
+    ]
+  },
+  "source_boundaries": {
+    "allowed_sources": [
+      "synthetic notification API brief",
+      "synthetic engineering notes"
+    ],
+    "excluded_sources": [
+      "real customer requirements",
+      "private repository issues",
+      "production incident logs",
+      "secrets or credentials"
+    ],
+    "canonical_write_allowed": false
+  },
+  "growth_rules": {
+    "allowed_object_families": [
+      "package",
+      "feature",
+      "requirement",
+      "constraint",
+      "risk",
+      "component",
+      "task",
+      "decision",
+      "evidence"
+    ],
+    "allowed_relation_families": [
+      "implements",
+      "depends_on",
+      "blocks",
+      "evidences",
+      "generates",
+      "related_to",
+      "supersedes"
+    ],
+    "max_initial_objects": 14,
+    "depth_mode": "light"
+  },
+  "review_gates": [
+    "human_review_before_canonical_write",
+    "public_safety_before_release",
+    "requirement_traceability_before_implementation"
+  ],
+  "generated_views": [
+    "seed_summary",
+    "candidate_object_list",
+    "traceability_view",
+    "risk_view",
+    "next_action_view"
+  ],
+  "stop_conditions": [
+    "real_customer_data_requested",
+    "implementation_requested_without_requirement_traceability",
+    "secret_or_credential_detected",
+    "candidate_count_exceeds_budget"
+  ]
+}

package/pilots/independent-implementation-002-software-specification/mirai-graph-package.json

@@ -0,0 +1,14 @@
+{
+  "id": "package.notification_api_spec_pilot_002",
+  "name": "Notification API Specification Pilot 002",
+  "version": "0.1.0",
+  "profile": "software_specification",
+  "conformance_level": "level_1",
+  "description": "A synthetic independent implementation pilot for a small software specification workflow.",
+  "license": "CC-BY-4.0",
+  "public_safety": "synthetic_public",
+  "graph": {
+    "objects": "graph/objects.json",
+    "relations": "graph/relations.json"
+  }
+}