mirai-graph 1.3.0 → 2.1.0

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

@@ -1,90 +0,0 @@
-{
-  "schema_version": "0.1.0",
-  "embryo_id": "embryo.notification_api_spec",
-  "seed_id": "seed.notification_api_spec",
-  "generated_at": "2026-05-28T18:22:20.166Z",
-  "candidate_objects": [
-    {
-      "id": "package.candidate_1",
-      "kind": "package",
-      "title": "Candidate Package",
-      "summary": "Candidate package object proposed from seed seed.notification_api_spec.",
-      "readiness": "draft",
-      "evidence": [],
-      "profile": "software_specification"
-    },
-    {
-      "id": "feature.candidate_2",
-      "kind": "feature",
-      "title": "Candidate Feature",
-      "summary": "Candidate feature object proposed from seed seed.notification_api_spec.",
-      "readiness": "draft",
-      "evidence": [],
-      "profile": "software_specification"
-    },
-    {
-      "id": "requirement.candidate_3",
-      "kind": "requirement",
-      "title": "Candidate Requirement",
-      "summary": "Candidate requirement object proposed from seed seed.notification_api_spec.",
-      "readiness": "draft",
-      "evidence": [],
-      "profile": "software_specification"
-    },
-    {
-      "id": "constraint.candidate_4",
-      "kind": "constraint",
-      "title": "Candidate Constraint",
-      "summary": "Candidate constraint object proposed from seed seed.notification_api_spec.",
-      "readiness": "draft",
-      "evidence": [],
-      "profile": "software_specification"
-    },
-    {
-      "id": "risk.candidate_5",
-      "kind": "risk",
-      "title": "Candidate Risk",
-      "summary": "Candidate risk object proposed from seed seed.notification_api_spec.",
-      "readiness": "draft",
-      "evidence": [],
-      "profile": "software_specification"
-    },
-    {
-      "id": "component.candidate_6",
-      "kind": "component",
-      "title": "Candidate Component",
-      "summary": "Candidate component object proposed from seed seed.notification_api_spec.",
-      "readiness": "draft",
-      "evidence": [],
-      "profile": "software_specification"
-    },
-    {
-      "id": "task.candidate_7",
-      "kind": "task",
-      "title": "Candidate Task",
-      "summary": "Candidate task object proposed from seed seed.notification_api_spec.",
-      "readiness": "draft",
-      "evidence": [],
-      "profile": "software_specification"
-    },
-    {
-      "id": "decision.candidate_8",
-      "kind": "decision",
-      "title": "Candidate Decision",
-      "summary": "Candidate decision object proposed from seed seed.notification_api_spec.",
-      "readiness": "draft",
-      "evidence": [],
-      "profile": "software_specification"
-    }
-  ],
-  "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-002-software-specification/results/package-validation.json

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

package/pilots/independent-implementation-002-software-specification/results/profile-conformance-result.json

@@ -1,28 +0,0 @@
-{
-  "schema_version": "0.1.0",
-  "result_id": "profile_conformance.package.notification_api_spec_pilot_002",
-  "checked_at": "2026-05-29",
-  "fixture": "pilots/independent-implementation-002-software-specification/",
-  "package_id": "package.notification_api_spec_pilot_002",
-  "profile": "software_specification",
-  "conformance_level": "level_1",
-  "validator": "packages/cli/validate-mirai-graph.js",
-  "command": "node packages/cli/validate-mirai-graph.js pilots/independent-implementation-002-software-specification",
-  "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",
-    "software_specification object-kind conformance",
-    "software_specification 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-002-software-specification/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: 11",
-    "relations exist: 10",
-    "evidence objects exist: 1",
-    "accepted objects exist: 2",
-    "gate results exist: 2"
-  ],
-  "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-002-software-specification/results/seed-validation.json

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

package/pilots/independent-implementation-002-software-specification/reviews/semantic-completeness-review.json

@@ -1,81 +0,0 @@
-{
-  "schema_version": "0.1.0",
-  "review_id": "semantic_review.notification_api_spec_pilot_002.task_implement_retry_policy",
-  "reviewed_at": "2026-05-28",
-  "reviewer": "Mirai Graph maintainers",
-  "protocol": "docs/research/semantic-completeness-review-protocol.md",
-  "target": {
-    "package_id": "package.notification_api_spec_pilot_002",
-    "context_pack": "pilots/independent-implementation-002-software-specification/results/context-pack.json",
-    "task_id": "task.implement_retry_policy"
-  },
-  "verdict": "pass_with_notes",
-  "score_total": 15,
-  "score_max": 16,
-  "dimensions": [
-    {
-      "name": "task_relevance",
-      "score": 2,
-      "note": "The context pack is centered on implementing the retry policy."
-    },
-    {
-      "name": "required_object_coverage",
-      "score": 2,
-      "note": "The task, retry feature, webhook feature, delivery worker, requirement, duplicate-delivery risk and idempotency decision are included."
-    },
-    {
-      "name": "required_relation_coverage",
-      "score": 2,
-      "note": "The task keeps direct traceability to the feature, requirement and idempotency decision."
-    },
-    {
-      "name": "evidence_preservation",
-      "score": 2,
-      "note": "The synthetic source brief is preserved."
-    },
-    {
-      "name": "risk_and_blocker_visibility",
-      "score": 2,
-      "note": "Duplicate delivery risk, credential leakage risk and no-secret-logging constraint are visible."
-    },
-    {
-      "name": "governance_gate_visibility",
-      "score": 1,
-      "note": "Requirement traceability is represented by relations, but gate results are not included in the context pack."
-    },
-    {
-      "name": "omission_transparency",
-      "score": 2,
-      "note": "The omitted package wrapper is listed."
-    },
-    {
-      "name": "no_private_or_unsafe_leakage",
-      "score": 2,
-      "note": "The package is synthetic and public-safe; safety-sensitive credential context is included."
-    }
-  ],
-  "required_context_preserved": [
-    "task.implement_retry_policy",
-    "feature.retry_policy",
-    "feature.webhook_delivery",
-    "requirement.notify_after_event",
-    "component.delivery_worker",
-    "risk.duplicate_delivery",
-    "constraint.no_secret_logging",
-    "risk.credential_leak",
-    "decision.idempotency_key_required"
-  ],
-  "important_omissions": [
-    {
-      "object_id": "package.team_notification_api",
-      "impact": "low",
-      "note": "The package wrapper is omitted but lower-level implementation context is preserved."
-    }
-  ],
-  "limitations": [
-    "The review is performed on a synthetic pilot package.",
-    "The review does not measure downstream implementation quality.",
-    "Selection scores are heuristic and do not prove semantic completeness."
-  ],
-  "claim_supported": "The generated context pack preserved task-relevant meaning with safety-sensitive context included."
-}

package/pilots/independent-implementation-003-ai-employee-workflow/README.md

@@ -1,42 +0,0 @@
-# Independent Implementation Pilot 003: AI Employee Workflow
-
-Status: pilot fixture
-
-## Purpose
-
-This pilot tests whether Mirai Graph can represent an AI employee workflow as a
-governed graph rather than a prompt-only agent description.
-
-## Domain
-
-Synthetic customer-support triage assistant.
-
-No private company, customer, employee, runtime trace, credential or internal
-project material is used.
-
-## Research Question
-
-Can a developer model an AI employee workflow with role, capability, policy,
-approval, result, feedback and learning boundaries using only public Mirai Graph
-materials?
-
-## 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-003-ai-employee-workflow/graph-seed.json
-node packages/cli/validate-mirai-graph.js pilots/independent-implementation-003-ai-employee-workflow
-node packages/cli/validate-mirai-graph.js --markdown pilots/independent-implementation-003-ai-employee-workflow
-```
-

package/pilots/independent-implementation-003-ai-employee-workflow/gates/results.json

@@ -1,30 +0,0 @@
-[
-  {
-    "id": "gate_result.ai_employee_workflow.public_safety",
-    "gate_id": "public_safety_before_release",
-    "target_id": "package.ai_employee_workflow_pilot_003",
-    "verdict": "pass",
-    "summary": "The pilot uses synthetic public-safe AI employee workflow material only.",
-    "reviewed_at": "2026-06-03",
-    "evidence": ["evidence.ai_employee_workflow_brief"]
-  },
-  {
-    "id": "gate_result.ai_employee_workflow.action_boundary",
-    "gate_id": "approval_before_external_action",
-    "target_id": "action.propose_customer_response",
-    "verdict": "pass_with_notes",
-    "summary": "The user-visible action is modeled as a proposed action requiring approval before execution.",
-    "reviewed_at": "2026-06-03",
-    "evidence": ["evidence.ai_employee_workflow_brief"]
-  },
-  {
-    "id": "gate_result.ai_employee_workflow.learning_boundary",
-    "gate_id": "feedback_learning_before_behavior_update",
-    "target_id": "lesson.escalate_sensitive_requests",
-    "verdict": "pass_with_notes",
-    "summary": "Feedback produces a review-ready lesson proposal and does not authorize automatic behavior update.",
-    "reviewed_at": "2026-06-03",
-    "evidence": ["evidence.ai_employee_workflow_brief"]
-  }
-]
-

package/pilots/independent-implementation-003-ai-employee-workflow/graph/objects.json

@@ -1,156 +0,0 @@
-[
-  {
-    "id": "evidence.ai_employee_workflow_brief",
-    "kind": "evidence",
-    "title": "Synthetic AI Employee Workflow Brief",
-    "summary": "Public-safe brief for a governed support-triage AI employee workflow.",
-    "readiness": "accepted",
-    "evidence": [],
-    "profile": "ai_employee"
-  },
-  {
-    "id": "department.customer_support",
-    "kind": "ai_department",
-    "title": "Customer Support Department",
-    "summary": "Synthetic department that owns the support-triage AI employee.",
-    "readiness": "accepted",
-    "evidence": ["evidence.ai_employee_workflow_brief"],
-    "profile": "ai_employee"
-  },
-  {
-    "id": "employee.triage_assistant",
-    "kind": "ai_employee",
-    "title": "Triage Assistant",
-    "summary": "Synthetic AI employee that classifies support requests and prepares proposed responses.",
-    "readiness": "review_ready",
-    "evidence": ["evidence.ai_employee_workflow_brief"],
-    "profile": "ai_employee"
-  },
-  {
-    "id": "role.support_triage_operator",
-    "kind": "role",
-    "title": "Support Triage Operator",
-    "summary": "Role responsible for classifying requests, selecting the next owner and preparing safe proposed actions.",
-    "readiness": "accepted",
-    "evidence": ["evidence.ai_employee_workflow_brief"],
-    "profile": "ai_employee"
-  },
-  {
-    "id": "skill.request_classification",
-    "kind": "skill",
-    "title": "Request Classification",
-    "summary": "Skill for classifying support requests by topic, urgency, sensitivity and owner.",
-    "readiness": "accepted",
-    "evidence": ["evidence.ai_employee_workflow_brief"],
-    "profile": "ai_employee"
-  },
-  {
-    "id": "knowledge.support_playbook",
-    "kind": "knowledge",
-    "title": "Support Playbook",
-    "summary": "Synthetic knowledge object for allowed response patterns and escalation rules.",
-    "readiness": "review_ready",
-    "evidence": ["evidence.ai_employee_workflow_brief"],
-    "profile": "ai_employee"
-  },
-  {
-    "id": "memory.reviewed_request_patterns",
-    "kind": "memory",
-    "title": "Reviewed Request Patterns",
-    "summary": "Reviewed pattern memory that can inform future classification after learning approval.",
-    "readiness": "draft",
-    "evidence": ["evidence.ai_employee_workflow_brief"],
-    "profile": "ai_employee"
-  },
-  {
-    "id": "tool.ticket_workspace",
-    "kind": "tool",
-    "title": "Ticket Workspace",
-    "summary": "Synthetic tool boundary for reading ticket context and writing approved ticket updates.",
-    "readiness": "review_ready",
-    "evidence": ["evidence.ai_employee_workflow_brief"],
-    "profile": "ai_employee"
-  },
-  {
-    "id": "capability.prepare_response",
-    "kind": "capability",
-    "title": "Prepare Response",
-    "summary": "Capability required to prepare a user-visible response proposal.",
-    "readiness": "review_ready",
-    "evidence": ["evidence.ai_employee_workflow_brief"],
-    "profile": "ai_employee"
-  },
-  {
-    "id": "policy.external_response_approval",
-    "kind": "policy",
-    "title": "External Response Approval",
-    "summary": "Policy requiring human approval before sending user-visible support responses.",
-    "readiness": "accepted",
-    "evidence": ["evidence.ai_employee_workflow_brief"],
-    "profile": "ai_employee"
-  },
-  {
-    "id": "gate.external_response_approval",
-    "kind": "governance_gate",
-    "title": "External Response Approval Gate",
-    "summary": "Gate that separates proposed support responses from executed responses.",
-    "readiness": "accepted",
-    "evidence": ["evidence.ai_employee_workflow_brief"],
-    "profile": "ai_employee"
-  },
-  {
-    "id": "workflow.support_triage",
-    "kind": "workflow",
-    "title": "Support Triage Workflow",
-    "summary": "Workflow for request classification, response proposal, approval, audited result and learning proposal.",
-    "readiness": "review_ready",
-    "evidence": ["evidence.ai_employee_workflow_brief"],
-    "profile": "ai_employee"
-  },
-  {
-    "id": "action.propose_customer_response",
-    "kind": "action",
-    "title": "Propose Customer Response",
-    "summary": "Proposed action that prepares a customer response but does not send it without approval.",
-    "readiness": "review_ready",
-    "evidence": ["evidence.ai_employee_workflow_brief"],
-    "profile": "ai_employee"
-  },
-  {
-    "id": "result.response_reviewed",
-    "kind": "result",
-    "title": "Response Reviewed Result",
-    "summary": "Audited result recording reviewer outcome for the proposed support response.",
-    "readiness": "draft",
-    "evidence": ["evidence.ai_employee_workflow_brief"],
-    "profile": "ai_employee"
-  },
-  {
-    "id": "feedback.response_quality_feedback",
-    "kind": "feedback",
-    "title": "Response Quality Feedback",
-    "summary": "Feedback from reviewing response quality, policy fit and escalation correctness.",
-    "readiness": "draft",
-    "evidence": ["evidence.ai_employee_workflow_brief"],
-    "profile": "ai_employee"
-  },
-  {
-    "id": "lesson.escalate_sensitive_requests",
-    "kind": "lesson",
-    "title": "Escalate Sensitive Requests",
-    "summary": "Proposed lesson that sensitive support requests should be escalated before drafting a response.",
-    "readiness": "review_ready",
-    "evidence": ["evidence.ai_employee_workflow_brief"],
-    "profile": "ai_employee"
-  },
-  {
-    "id": "endpoint.specialist_support_service",
-    "kind": "federation_endpoint",
-    "title": "Specialist Support Service",
-    "summary": "Synthetic federation endpoint for escalating specialized support requests.",
-    "readiness": "draft",
-    "evidence": ["evidence.ai_employee_workflow_brief"],
-    "profile": "ai_employee"
-  }
-]
-

package/pilots/independent-implementation-003-ai-employee-workflow/graph/relations.json

@@ -1,147 +0,0 @@
-[
-  {
-    "id": "relation.employee.triage_assistant.belongs_to_department.department.customer_support",
-    "type": "belongs_to_department",
-    "source": "employee.triage_assistant",
-    "target": "department.customer_support",
-    "readiness": "accepted",
-    "evidence": ["evidence.ai_employee_workflow_brief"],
-    "profile": "ai_employee"
-  },
-  {
-    "id": "relation.employee.triage_assistant.has_role.role.support_triage_operator",
-    "type": "has_role",
-    "source": "employee.triage_assistant",
-    "target": "role.support_triage_operator",
-    "readiness": "accepted",
-    "evidence": ["evidence.ai_employee_workflow_brief"],
-    "profile": "ai_employee"
-  },
-  {
-    "id": "relation.role.support_triage_operator.has_skill.skill.request_classification",
-    "type": "has_skill",
-    "source": "role.support_triage_operator",
-    "target": "skill.request_classification",
-    "readiness": "accepted",
-    "evidence": ["evidence.ai_employee_workflow_brief"],
-    "profile": "ai_employee"
-  },
-  {
-    "id": "relation.skill.request_classification.uses_knowledge.knowledge.support_playbook",
-    "type": "uses_knowledge",
-    "source": "skill.request_classification",
-    "target": "knowledge.support_playbook",
-    "readiness": "review_ready",
-    "evidence": ["evidence.ai_employee_workflow_brief"],
-    "profile": "ai_employee"
-  },
-  {
-    "id": "relation.skill.request_classification.uses_knowledge.memory.reviewed_request_patterns",
-    "type": "uses_knowledge",
-    "source": "skill.request_classification",
-    "target": "memory.reviewed_request_patterns",
-    "readiness": "draft",
-    "evidence": ["evidence.ai_employee_workflow_brief"],
-    "profile": "ai_employee"
-  },
-  {
-    "id": "relation.employee.triage_assistant.requires_capability.capability.prepare_response",
-    "type": "requires_capability",
-    "source": "employee.triage_assistant",
-    "target": "capability.prepare_response",
-    "readiness": "review_ready",
-    "evidence": ["evidence.ai_employee_workflow_brief"],
-    "profile": "ai_employee"
-  },
-  {
-    "id": "relation.tool.ticket_workspace.can_execute.action.propose_customer_response",
-    "type": "can_execute",
-    "source": "tool.ticket_workspace",
-    "target": "action.propose_customer_response",
-    "readiness": "review_ready",
-    "evidence": ["evidence.ai_employee_workflow_brief"],
-    "profile": "ai_employee"
-  },
-  {
-    "id": "relation.action.propose_customer_response.requires_capability.capability.prepare_response",
-    "type": "requires_capability",
-    "source": "action.propose_customer_response",
-    "target": "capability.prepare_response",
-    "readiness": "review_ready",
-    "evidence": ["evidence.ai_employee_workflow_brief"],
-    "profile": "ai_employee"
-  },
-  {
-    "id": "relation.action.propose_customer_response.requires_approval.gate.external_response_approval",
-    "type": "requires_approval",
-    "source": "action.propose_customer_response",
-    "target": "gate.external_response_approval",
-    "readiness": "accepted",
-    "evidence": ["evidence.ai_employee_workflow_brief"],
-    "profile": "ai_employee"
-  },
-  {
-    "id": "relation.policy.external_response_approval.governs.gate.external_response_approval",
-    "type": "governs",
-    "source": "policy.external_response_approval",
-    "target": "gate.external_response_approval",
-    "readiness": "accepted",
-    "evidence": ["evidence.ai_employee_workflow_brief"],
-    "profile": "ai_employee"
-  },
-  {
-    "id": "relation.workflow.support_triage.triggered_by.employee.triage_assistant",
-    "type": "triggered_by",
-    "source": "workflow.support_triage",
-    "target": "employee.triage_assistant",
-    "readiness": "review_ready",
-    "evidence": ["evidence.ai_employee_workflow_brief"],
-    "profile": "ai_employee"
-  },
-  {
-    "id": "relation.action.propose_customer_response.produces.result.response_reviewed",
-    "type": "produces",
-    "source": "action.propose_customer_response",
-    "target": "result.response_reviewed",
-    "readiness": "draft",
-    "evidence": ["evidence.ai_employee_workflow_brief"],
-    "profile": "ai_employee"
-  },
-  {
-    "id": "relation.feedback.response_quality_feedback.responds_to.result.response_reviewed",
-    "type": "responds_to",
-    "source": "feedback.response_quality_feedback",
-    "target": "result.response_reviewed",
-    "readiness": "draft",
-    "evidence": ["evidence.ai_employee_workflow_brief"],
-    "profile": "ai_employee"
-  },
-  {
-    "id": "relation.lesson.escalate_sensitive_requests.learns_from.feedback.response_quality_feedback",
-    "type": "learns_from",
-    "source": "lesson.escalate_sensitive_requests",
-    "target": "feedback.response_quality_feedback",
-    "readiness": "review_ready",
-    "evidence": ["evidence.ai_employee_workflow_brief"],
-    "profile": "ai_employee"
-  },
-  {
-    "id": "relation.lesson.escalate_sensitive_requests.updates_behavior.workflow.support_triage",
-    "type": "updates_behavior",
-    "source": "lesson.escalate_sensitive_requests",
-    "target": "workflow.support_triage",
-    "readiness": "review_ready",
-    "evidence": ["evidence.ai_employee_workflow_brief"],
-    "profile": "ai_employee"
-  },
-  {
-    "id": "relation.employee.triage_assistant.federates_with.endpoint.specialist_support_service",
-    "type": "federates_with",
-    "source": "employee.triage_assistant",
-    "target": "endpoint.specialist_support_service",
-    "readiness": "draft",
-    "evidence": ["evidence.ai_employee_workflow_brief"],
-    "profile": "ai_employee"
-  }
-]
-