mirai-graph 1.0.0-rc.1

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

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

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

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

@@ -0,0 +1,90 @@
+{
+  "schema_version": "0.1.0",
+  "seed_id": "seed.ai_employee_workflow_pilot",
+  "target_graph_id": "graph.ai_employee_workflow_pilot",
+  "purpose": "Create a public-safe Mirai Graph package for a governed AI employee workflow.",
+  "target_profile": "profile.ai_employee",
+  "target_mode": "pilot",
+  "graph_dna": {
+    "purpose": "Keep AI employee role, capability, policy, action, result, feedback and learning boundaries connected.",
+    "evolution_vector": "Grow from a small support-triage assistant graph into a governed AI department or federated service model.",
+    "non_negotiable_principles": [
+      "The pilot must remain synthetic and public-safe.",
+      "External or user-visible actions must be modeled as proposed actions until approval is recorded.",
+      "Feedback and lessons must not update behavior automatically."
+    ]
+  },
+  "source_boundaries": {
+    "allowed_sources": [
+      "synthetic support triage scenario",
+      "public Mirai Graph AI employee profile",
+      "public Mirai Graph implementation-control boundaries"
+    ],
+    "excluded_sources": [
+      "real customer tickets",
+      "private employee records",
+      "production runtime traces",
+      "secrets or credentials"
+    ],
+    "canonical_write_allowed": false
+  },
+  "growth_rules": {
+    "allowed_object_families": [
+      "ai_employee",
+      "ai_department",
+      "role",
+      "skill",
+      "knowledge",
+      "memory",
+      "tool",
+      "capability",
+      "policy",
+      "governance_gate",
+      "workflow",
+      "action",
+      "result",
+      "feedback",
+      "lesson",
+      "federation_endpoint",
+      "evidence"
+    ],
+    "allowed_relation_families": [
+      "belongs_to_department",
+      "has_role",
+      "has_skill",
+      "uses_knowledge",
+      "requires_capability",
+      "can_execute",
+      "requires_approval",
+      "governs",
+      "triggered_by",
+      "produces",
+      "responds_to",
+      "learns_from",
+      "updates_behavior",
+      "federates_with"
+    ],
+    "max_initial_objects": 18,
+    "depth_mode": "standard"
+  },
+  "review_gates": [
+    "human_review_before_canonical_write",
+    "approval_before_external_action",
+    "feedback_learning_before_behavior_update",
+    "public_safety_before_release"
+  ],
+  "generated_views": [
+    "role_capability_view",
+    "approval_boundary_view",
+    "feedback_learning_view",
+    "federation_view",
+    "next_action_view"
+  ],
+  "stop_conditions": [
+    "real_customer_data_requested",
+    "action_modeled_as_executed_without_approval",
+    "feedback_directly_changes_behavior",
+    "secret_or_credential_detected"
+  ]
+}
+

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

@@ -0,0 +1,15 @@
+{
+  "id": "package.ai_employee_workflow_pilot_003",
+  "name": "AI Employee Workflow Pilot 003",
+  "version": "0.1.0",
+  "profile": "ai_employee",
+  "conformance_level": "level_1",
+  "description": "A synthetic independent implementation pilot for a governed AI employee workflow.",
+  "license": "CC-BY-4.0",
+  "public_safety": "synthetic_public",
+  "graph": {
+    "objects": "graph/objects.json",
+    "relations": "graph/relations.json"
+  }
+}
+

package/pilots/independent-implementation-003-ai-employee-workflow/reports/pilot-report.md

@@ -0,0 +1,49 @@
+# Pilot Report: AI Employee Workflow
+
+Status: public-safe alpha pilot
+
+## Question
+
+Can Mirai Graph represent an AI employee workflow as an executable governance
+surface rather than a prompt-only agent description?
+
+## Setup
+
+The pilot uses a synthetic customer-support triage assistant. The graph connects:
+
+- AI employee and department;
+- role and skill;
+- knowledge and reviewed memory;
+- tool and capability;
+- proposed action and approval gate;
+- audited result, feedback and lesson proposal;
+- optional federation endpoint.
+
+## Result
+
+The package validates against the public `ai_employee` profile. The graph keeps
+the action/runtime boundary explicit: the assistant may prepare a proposed
+customer response, but the graph does not treat that proposal as an executed
+action.
+
+## Evidence Boundary
+
+This pilot demonstrates public profile applicability and validation shape. It
+does not claim production safety, customer-support quality, model accuracy or
+peer-reviewed effectiveness.
+
+## Reproducibility
+
+```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
+```
+
+## Limitations
+
+- The scenario is synthetic.
+- No real customer tickets or runtime traces are included.
+- The current CLI checks conformance and boundaries, not runtime behavior.
+- Feedback remains a proposal source and does not authorize canonical update.
+

package/pilots/independent-implementation-003-ai-employee-workflow/results/profile-conformance-result.json

@@ -0,0 +1,30 @@
+{
+  "schema_version": "0.1.0",
+  "result_id": "profile_conformance.package.ai_employee_workflow_pilot_003",
+  "checked_at": "2026-06-03",
+  "fixture": "pilots/independent-implementation-003-ai-employee-workflow/",
+  "package_id": "package.ai_employee_workflow_pilot_003",
+  "profile": "ai_employee",
+  "conformance_level": "level_1",
+  "validator": "packages/cli/validate-mirai-graph.js",
+  "command": "node packages/cli/validate-mirai-graph.js pilots/independent-implementation-003-ai-employee-workflow",
+  "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",
+    "ai_employee object-kind conformance",
+    "ai_employee relation-type conformance",
+    "approval boundary represented for user-visible action",
+    "feedback links to lesson proposal without automatic behavior update"
+  ],
+  "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 production AI employee effectiveness.",
+    "The validator checks graph conformance, not runtime safety or model quality."
+  ]
+}

package/pilots/independent-implementation-004-research-program/README.md

@@ -0,0 +1,41 @@
+# Independent Implementation Pilot 004: Research Program
+
+Status: pilot fixture
+
+## Purpose
+
+This pilot tests whether Mirai Graph can model a small research-program workflow
+with explicit evidence, milestones, risks and publication gates.
+
+## Domain
+
+Synthetic research program for evaluating a graph-assisted project workflow.
+
+No private research repository, unpublished manuscript, reviewer note, customer
+data, internal handoff or runtime trace is used.
+
+## Research Question
+
+Can a developer model a public-safe research program as a governed Mirai Graph
+package using only public profiles, examples and validators?
+
+## Files
+
+- `graph-seed.json`
+- `mirai-graph-package.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-004-research-program/graph-seed.json
+node packages/cli/validate-mirai-graph.js pilots/independent-implementation-004-research-program
+node packages/cli/validate-mirai-graph.js --markdown pilots/independent-implementation-004-research-program
+```
+

package/pilots/independent-implementation-004-research-program/gates/results.json

@@ -0,0 +1,21 @@
+[
+  {
+    "id": "gate_result.research_program.public_safety",
+    "gate_id": "public_safety_before_release",
+    "target_id": "package.research_program_pilot_004",
+    "verdict": "pass",
+    "summary": "The pilot uses synthetic public-safe research-program material only.",
+    "reviewed_at": "2026-06-03",
+    "evidence": ["evidence.research_program_brief"]
+  },
+  {
+    "id": "gate_result.research_program.claim_boundary",
+    "gate_id": "evidence_review_before_publication_claim",
+    "target_id": "decision.limit_claim_to_alpha_evidence",
+    "verdict": "pass_with_notes",
+    "summary": "The graph explicitly blocks overclaiming synthetic evidence as broad scientific proof.",
+    "reviewed_at": "2026-06-03",
+    "evidence": ["evidence.research_program_brief"]
+  }
+]
+

package/pilots/independent-implementation-004-research-program/graph/objects.json

@@ -0,0 +1,102 @@
+[
+  {
+    "id": "evidence.research_program_brief",
+    "kind": "evidence",
+    "title": "Synthetic Research Program Brief",
+    "summary": "Public-safe brief for a synthetic research program about graph-assisted work.",
+    "readiness": "accepted",
+    "evidence": [],
+    "profile": "project_management"
+  },
+  {
+    "id": "system.graph_assisted_work_research",
+    "kind": "system",
+    "title": "Graph-Assisted Work Research",
+    "summary": "Synthetic research program used to evaluate Mirai Graph-style project control.",
+    "readiness": "review_ready",
+    "evidence": ["evidence.research_program_brief"],
+    "profile": "project_management"
+  },
+  {
+    "id": "goal.measure_context_quality",
+    "kind": "goal",
+    "title": "Measure Context Quality",
+    "summary": "Evaluate whether graph-generated context improves dependency and evidence coverage.",
+    "readiness": "review_ready",
+    "evidence": ["evidence.research_program_brief"],
+    "profile": "project_management"
+  },
+  {
+    "id": "task.define_baseline_protocol",
+    "kind": "task",
+    "title": "Define Baseline Protocol",
+    "summary": "Define a baseline-vs-Mirai Graph comparison protocol for one synthetic task.",
+    "readiness": "accepted",
+    "evidence": ["evidence.research_program_brief"],
+    "profile": "project_management"
+  },
+  {
+    "id": "task.collect_synthetic_result",
+    "kind": "task",
+    "title": "Collect Synthetic Result",
+    "summary": "Record context size, missed dependencies, unsupported assumptions and evidence coverage.",
+    "readiness": "review_ready",
+    "evidence": ["evidence.research_program_brief"],
+    "profile": "project_management"
+  },
+  {
+    "id": "evidence.synthetic_result_table",
+    "kind": "evidence",
+    "title": "Synthetic Result Table",
+    "summary": "Synthetic metric table used for reproducibility and limitation review.",
+    "readiness": "review_ready",
+    "evidence": ["evidence.research_program_brief"],
+    "profile": "project_management"
+  },
+  {
+    "id": "risk.overclaiming_synthetic_result",
+    "kind": "risk",
+    "title": "Overclaiming Synthetic Result",
+    "summary": "Synthetic evidence may be mistaken for broad scientific proof.",
+    "readiness": "review_ready",
+    "evidence": ["evidence.research_program_brief"],
+    "profile": "project_management"
+  },
+  {
+    "id": "decision.limit_claim_to_alpha_evidence",
+    "kind": "decision",
+    "title": "Limit Claim To Alpha Evidence",
+    "summary": "Publication wording must separate synthetic evidence, pilot evidence and scientific proof.",
+    "readiness": "accepted",
+    "evidence": ["evidence.research_program_brief"],
+    "profile": "project_management"
+  },
+  {
+    "id": "gate.publication_claim_review",
+    "kind": "governance_gate",
+    "title": "Publication Claim Review Gate",
+    "summary": "Review gate before treating synthetic or pilot evidence as a publication claim.",
+    "readiness": "accepted",
+    "evidence": ["evidence.research_program_brief"],
+    "profile": "project_management"
+  },
+  {
+    "id": "milestone.preprint_outline_ready",
+    "kind": "milestone",
+    "title": "Preprint Outline Ready",
+    "summary": "Milestone reached when protocol, limitations and evidence boundaries are documented.",
+    "readiness": "review_ready",
+    "evidence": ["evidence.synthetic_result_table"],
+    "profile": "project_management"
+  },
+  {
+    "id": "stakeholder.research_reviewer",
+    "kind": "stakeholder",
+    "title": "Research Reviewer",
+    "summary": "Reviewer role responsible for checking limitations and claim boundaries.",
+    "readiness": "draft",
+    "evidence": ["evidence.research_program_brief"],
+    "profile": "project_management"
+  }
+]
+