mirai-graph 1.4.0 → 2.1.0

package/benchmarks/synthetic-context-reduction-v0/results/context-pack.json

@@ -1,181 +0,0 @@
-{
-  "id": "context_pack.task_notify_after_approval",
-  "task_id": "task.notify_after_approval",
-  "source_graph": "package.synthetic_context_reduction_v0",
-  "generated_at": "2026-05-28T19:46:09.373Z",
-  "included_objects": [
-    "source.identity_access",
-    "source.content_workflow",
-    "source.audit_events",
-    "source.notification_delivery",
-    "pkg.content_workflow",
-    "pkg.audit_events",
-    "pkg.notification_delivery",
-    "feature.workflow_transition",
-    "feature.scoped_api_token",
-    "constraint.audit_before_notify",
-    "risk.duplicate_notifications"
-  ],
-  "included_relations": [
-    "relation.pkg.content_workflow.implements.feature.workflow_transition",
-    "relation.pkg.notification_delivery.depends_on.feature.scoped_api_token",
-    "relation.pkg.audit_events.evidences.feature.workflow_transition",
-    "relation.pkg.notification_delivery.blocks.constraint.audit_before_notify",
-    "relation.constraint.audit_before_notify.depends_on.pkg.audit_events",
-    "relation.feature.workflow_transition.generates.pkg.notification_delivery",
-    "relation.pkg.notification_delivery.related_to.risk.duplicate_notifications"
-  ],
-  "evidence": [
-    "source.content_workflow",
-    "source.audit_events",
-    "source.notification_delivery",
-    "source.identity_access"
-  ],
-  "selection": {
-    "method": "token_matching_one_hop_relation_expansion_safety_shared_evidence",
-    "task_tokens": [
-      "task",
-      "notify",
-      "after",
-      "approve"
-    ],
-    "object_explanations": [
-      {
-        "id": "source.identity_access",
-        "relevance_score": -1,
-        "reasons": [
-          "evidence referenced by selected object"
-        ]
-      },
-      {
-        "id": "source.content_workflow",
-        "relevance_score": 2,
-        "reasons": [
-          "exact token match: approve",
-          "evidence object penalty until linked by selected graph context"
-        ]
-      },
-      {
-        "id": "source.audit_events",
-        "relevance_score": -1,
-        "reasons": [
-          "evidence referenced by selected object"
-        ]
-      },
-      {
-        "id": "source.notification_delivery",
-        "relevance_score": 2,
-        "reasons": [
-          "exact token match: notify",
-          "evidence object penalty until linked by selected graph context"
-        ]
-      },
-      {
-        "id": "pkg.content_workflow",
-        "relevance_score": 3,
-        "reasons": [
-          "exact token match: approve"
-        ]
-      },
-      {
-        "id": "pkg.audit_events",
-        "relevance_score": 0,
-        "reasons": [
-          "one-hop relation expansion from relation.constraint.audit_before_notify.depends_on.pkg.audit_events"
-        ]
-      },
-      {
-        "id": "pkg.notification_delivery",
-        "relevance_score": 6,
-        "reasons": [
-          "exact token match: notify",
-          "exact token match: after"
-        ]
-      },
-      {
-        "id": "feature.workflow_transition",
-        "relevance_score": 0,
-        "reasons": [
-          "one-hop relation expansion from relation.pkg.content_workflow.implements.feature.workflow_transition"
-        ]
-      },
-      {
-        "id": "feature.scoped_api_token",
-        "relevance_score": 0,
-        "reasons": [
-          "one-hop relation expansion from relation.pkg.notification_delivery.depends_on.feature.scoped_api_token"
-        ]
-      },
-      {
-        "id": "constraint.audit_before_notify",
-        "relevance_score": 6,
-        "reasons": [
-          "exact token match: notify",
-          "exact token match: approve"
-        ]
-      },
-      {
-        "id": "risk.duplicate_notifications",
-        "relevance_score": 3,
-        "reasons": [
-          "exact token match: notify"
-        ]
-      }
-    ],
-    "relation_explanations": [
-      {
-        "id": "relation.pkg.content_workflow.implements.feature.workflow_transition",
-        "reason": "one-hop relation expansion from direct object match",
-        "source": "pkg.content_workflow",
-        "target": "feature.workflow_transition"
-      },
-      {
-        "id": "relation.pkg.notification_delivery.depends_on.feature.scoped_api_token",
-        "reason": "one-hop relation expansion from direct object match",
-        "source": "pkg.notification_delivery",
-        "target": "feature.scoped_api_token"
-      },
-      {
-        "id": "relation.pkg.audit_events.evidences.feature.workflow_transition",
-        "reason": "connects selected objects after safety/evidence expansion",
-        "source": "pkg.audit_events",
-        "target": "feature.workflow_transition"
-      },
-      {
-        "id": "relation.pkg.notification_delivery.blocks.constraint.audit_before_notify",
-        "reason": "one-hop relation expansion from direct object match",
-        "source": "pkg.notification_delivery",
-        "target": "constraint.audit_before_notify"
-      },
-      {
-        "id": "relation.constraint.audit_before_notify.depends_on.pkg.audit_events",
-        "reason": "one-hop relation expansion from direct object match",
-        "source": "constraint.audit_before_notify",
-        "target": "pkg.audit_events"
-      },
-      {
-        "id": "relation.feature.workflow_transition.generates.pkg.notification_delivery",
-        "reason": "one-hop relation expansion from direct object match",
-        "source": "feature.workflow_transition",
-        "target": "pkg.notification_delivery"
-      },
-      {
-        "id": "relation.pkg.notification_delivery.related_to.risk.duplicate_notifications",
-        "reason": "one-hop relation expansion from direct object match",
-        "source": "pkg.notification_delivery",
-        "target": "risk.duplicate_notifications"
-      }
-    ]
-  },
-  "assumptions": [
-    "Alpha generator uses token matching plus one-hop relation expansion.",
-    "Safety-sensitive constraints and risks with shared evidence are included."
-  ],
-  "omissions": [
-    "pkg.identity_access"
-  ],
-  "limitations": [
-    "Generated context pack is not canonical state.",
-    "This alpha generator does not prove semantic completeness."
-  ]
-}

package/benchmarks/synthetic-context-reduction-v0/results/context-reduction-result.json

@@ -1,8 +0,0 @@
-{
-  "schema_version": "0.1.0",
-  "task_id": "task.notify_after_approval",
-  "baseline_context_units": 620,
-  "graph_context_units": 270,
-  "total_reduction_percent": 56.4516,
-  "note": "Synthetic demonstration only; do not merge with internal empirical metrics."
-}

package/benchmarks/synthetic-context-reduction-v0/results/profile-conformance-result.json

@@ -1,28 +0,0 @@
-{
-  "schema_version": "0.1.0",
-  "result_id": "profile_conformance.package.synthetic_context_reduction_v0",
-  "checked_at": "2026-05-29",
-  "fixture": "benchmarks/synthetic-context-reduction-v0/",
-  "package_id": "package.synthetic_context_reduction_v0",
-  "profile": "software_specification",
-  "conformance_level": "level_1",
-  "validator": "packages/cli/validate-mirai-graph.js",
-  "command": "node packages/cli/validate-mirai-graph.js benchmarks/synthetic-context-reduction-v0",
-  "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 benchmark package is synthetic public-safe evidence."
-  ]
-}

package/benchmarks/synthetic-context-reduction-v0/results/readiness-score.json

@@ -1,24 +0,0 @@
-{
-  "schema_version": "0.1.0",
-  "target_mode": "pilot",
-  "score": 69,
-  "band": "G3_pilot_ready",
-  "evidence": [
-    "package manifest exists",
-    "objects exist: 12",
-    "relations exist: 8",
-    "evidence objects exist: 4",
-    "accepted objects exist: 4",
-    "gate results exist: 1",
-    "context pack example exists",
-    "benchmark metric example exists"
-  ],
-  "blockers": [],
-  "caps": [
-    {
-      "reason": "synthetic-only evidence cannot exceed pilot-ready navigation score",
-      "max_score": 69
-    }
-  ],
-  "note": "Release-candidate readiness score; use as navigation, not approval."
-}

package/benchmarks/synthetic-context-reduction-v0/reviews/semantic-completeness-review.json

@@ -1,78 +0,0 @@
-{
-  "schema_version": "0.1.0",
-  "review_id": "semantic_review.synthetic_context_reduction_v0.task_notify_after_approval",
-  "reviewed_at": "2026-05-28",
-  "reviewer": "Mirai Graph maintainers",
-  "protocol": "docs/research/semantic-completeness-review-protocol.md",
-  "target": {
-    "package_id": "package.synthetic_context_reduction_v0",
-    "context_pack": "benchmarks/synthetic-context-reduction-v0/results/context-pack.json",
-    "task_id": "task.notify_after_approval"
-  },
-  "verdict": "pass_with_notes",
-  "score_total": 15,
-  "score_max": 16,
-  "dimensions": [
-    {
-      "name": "task_relevance",
-      "score": 2,
-      "note": "The context pack is centered on notification after approval."
-    },
-    {
-      "name": "required_object_coverage",
-      "score": 2,
-      "note": "Notification delivery, workflow transition, scoped token, audit constraint and duplicate-notification risk are included."
-    },
-    {
-      "name": "required_relation_coverage",
-      "score": 2,
-      "note": "The included relations preserve dependency, evidence, blocking and generation paths needed for the task."
-    },
-    {
-      "name": "evidence_preservation",
-      "score": 2,
-      "note": "All source evidence referenced by included objects and relations is preserved."
-    },
-    {
-      "name": "risk_and_blocker_visibility",
-      "score": 2,
-      "note": "The audit-before-notify constraint and duplicate notification risk remain visible."
-    },
-    {
-      "name": "governance_gate_visibility",
-      "score": 1,
-      "note": "The package has no explicit governance gate object; the safety constraint is visible but not modeled as a gate."
-    },
-    {
-      "name": "omission_transparency",
-      "score": 2,
-      "note": "Omitted package-level objects are listed."
-    },
-    {
-      "name": "no_private_or_unsafe_leakage",
-      "score": 2,
-      "note": "The package is synthetic and contains no private material."
-    }
-  ],
-  "required_context_preserved": [
-    "pkg.notification_delivery",
-    "feature.workflow_transition",
-    "feature.scoped_api_token",
-    "constraint.audit_before_notify",
-    "risk.duplicate_notifications"
-  ],
-  "important_omissions": [
-    {
-      "object_id": "pkg.identity_access",
-      "impact": "low",
-      "note": "The scoped API token feature and source evidence are included, so the omitted package wrapper does not block this task."
-    }
-  ],
-  "limitations": [
-    "The review is performed on a synthetic package.",
-    "The review does not measure downstream implementation quality.",
-    "The package does not yet model governance gates as graph objects.",
-    "Selection scores are heuristic and do not prove semantic completeness."
-  ],
-  "claim_supported": "The generated context pack preserved task-relevant meaning under this review protocol."
-}

package/benchmarks/synthetic-context-reduction-v0/scripts/calculate-context-reduction.js

@@ -1,42 +0,0 @@
-#!/usr/bin/env node
-
-const fs = require("fs");
-const path = require("path");
-
-const packageRoot = path.resolve(__dirname, "..");
-const writeFlagIndex = process.argv.indexOf("--write");
-const outputPath = writeFlagIndex >= 0 ? process.argv[writeFlagIndex + 1] : null;
-const metricsPath = path.join(packageRoot, "metrics", "example-metrics.json");
-const metrics = JSON.parse(fs.readFileSync(metricsPath, "utf8"));
-
-const baseline = metrics.baseline.estimated_context_units;
-const graphContext = metrics.graph_context.estimated_context_units;
-
-if (!Number.isFinite(baseline) || baseline <= 0) {
-  throw new Error("baseline.estimated_context_units must be a positive number");
-}
-
-if (!Number.isFinite(graphContext) || graphContext < 0) {
-  throw new Error("graph_context.estimated_context_units must be a non-negative number");
-}
-
-const reductionPercent = ((baseline - graphContext) / baseline) * 100;
-
-const result = {
-  schema_version: "0.1.0",
-  task_id: metrics.task_id,
-  baseline_context_units: baseline,
-  graph_context_units: graphContext,
-  total_reduction_percent: Number(reductionPercent.toFixed(4)),
-  note: "Synthetic demonstration only; do not merge with internal empirical metrics."
-};
-
-const output = JSON.stringify(result, null, 2);
-
-if (outputPath) {
-  const resolvedOutputPath = path.resolve(outputPath);
-  fs.mkdirSync(path.dirname(resolvedOutputPath), { recursive: true });
-  fs.writeFileSync(resolvedOutputPath, `${output}\n`);
-}
-
-console.log(output);

package/benchmarks/synthetic-context-reduction-v0/source-corpus/audit-events.md

@@ -1,8 +0,0 @@
-# Audit Events Package
-
-The audit package stores append-only events for security-relevant actions and
-workflow transitions. Events must include actor identity, action type, target
-object and correlation identifier.
-
-Open issue: audit records should be queryable by administrators without
-exposing private draft content.

package/benchmarks/synthetic-context-reduction-v0/source-corpus/content-workflow.md

@@ -1,8 +0,0 @@
-# Content Workflow Package
-
-The workflow package manages draft, review, approved and published states.
-Every state transition must store actor, timestamp, previous state, next state
-and reason.
-
-Open issue: publication approval should trigger notifications, but only after
-audit events are persisted.

package/benchmarks/synthetic-context-reduction-v0/source-corpus/identity-access.md

@@ -1,8 +0,0 @@
-# Identity And Access Package
-
-The platform needs account registration, role assignment and scoped API tokens.
-Editors can create drafts, reviewers can approve publication and administrators
-can manage roles.
-
-Open issue: API tokens must be auditable because notification delivery may act
-on behalf of a user.

package/benchmarks/synthetic-context-reduction-v0/source-corpus/notification-delivery.md

@@ -1,8 +0,0 @@
-# Notification Delivery Package
-
-The notification package sends email and webhook messages when important
-workflow events occur. Delivery workers must use scoped tokens and must not send
-notifications until the triggering event has been audited.
-
-Open issue: retry behavior must avoid duplicate notifications for the same
-workflow transition.

package/benchmarks/synthetic-context-reduction-v0/tasks/tasks.json

@@ -1,31 +0,0 @@
-[
-  {
-    "id": "task.notify_after_approval",
-    "prompt": "Prepare the implementation context for sending notifications after content approval.",
-    "baseline_sources": [
-      "source-corpus/identity-access.md",
-      "source-corpus/content-workflow.md",
-      "source-corpus/audit-events.md",
-      "source-corpus/notification-delivery.md"
-    ],
-    "graph_seed_objects": [
-      "feature.workflow_transition",
-      "constraint.audit_before_notify",
-      "pkg.notification_delivery"
-    ],
-    "expected_context_objects": [
-      "pkg.content_workflow",
-      "feature.workflow_transition",
-      "pkg.audit_events",
-      "constraint.audit_before_notify",
-      "pkg.notification_delivery",
-      "feature.scoped_api_token",
-      "risk.duplicate_notifications"
-    ],
-    "acceptance_notes": [
-      "Context must include the audit-before-notify constraint.",
-      "Context must include scoped-token dependency.",
-      "Context must flag duplicate notification risk."
-    ]
-  }
-]

package/docs/README.md

@@ -1,130 +0,0 @@
-# Mirai Graph Documentation Map
-
-Status: 1.0 release-candidate documentation map
-
-This page helps readers choose the right Mirai Graph documents without reading
-the whole repository.
-
-## Start Here
-
-- New adopter: [Connect A Project In 15 Minutes](adoption/connect-project-15-minutes.md)
-- Developer entry point: [Mirai Graph For Developers](adoption/for-developers.md)
-- General onboarding: [Getting Started](adoption/getting-started.md)
-- Role-oriented kit: [1.0 RC Adopter Kit](adoption/adopter-kit.md)
-- CLI usage: [Mirai Graph CLI](adoption/cli.md)
-- Project purpose: [Repository Purpose](repository-purpose.md)
-- Terminology: [Terminology](terminology.md)
-
-## Adoption
-
-- [Choose A Profile](adoption/choose-profile.md)
-- [Mirai Graph For Developers](adoption/for-developers.md)
-- [Developer Integration Guide](adoption/developer-integration-guide.md)
-- [End-To-End Control Loop](adoption/end-to-end-control-loop.md)
-- [Seed To Validated Package](adoption/seed-to-validated-package.md)
-- [AI Employee Graph Adoption](adoption/ai-employee-graph.md)
-- [Character Layer Adoption](adoption/character-layer.md)
-- [Profile Conformance Fixtures](adoption/profile-conformance-fixtures.md)
-- [Mirai Graph Transition](adoption/mirai-graph-transition.md)
-
-## Standard
-
-Core model:
-
-- [Object Model](../standard/object-model.md)
-- [Relation Model](../standard/relation-model.md)
-- [Lifecycle Readiness](../standard/lifecycle-readiness.md)
-- [Evidence Provenance](../standard/evidence-provenance.md)
-- [Context Pack Generation](../standard/context-pack-generation.md)
-- [Governance](../standard/governance.md)
-- [Hybrid Source Of Truth](../standard/hybrid-source-of-truth.md)
-- [Profile Boundaries](../standard/profile-boundaries.md)
-
-Executable process and implementation control:
-
-- [Implementation Control](../standard/implementation-control.md)
-- [Implementation Control Cycles](../standard/implementation-control-cycles.md)
-- [Launch Record](../standard/launch-record.md)
-- [Work State Machine](../standard/work-state-machine.md)
-- [Process Control Contract](../standard/process-control-contract.md)
-- [Technology Quality Feedback](../standard/technology-quality-feedback.md)
-- [Dynamic Episode Layer](../standard/dynamic-episode-layer.md)
-- [Semantic Intent Resolution](../standard/semantic-intent-resolution.md)
-- [Goal Vector Quality Control](../standard/goal-vector-quality-control.md)
-- [Episode Trace](../standard/episode-trace.md)
-- [Dynamic Layer For AI-Assisted Code Generation](../standard/dynamic-layer-code-generation.md)
-- [Recovery Resume](../standard/recovery-resume.md)
-- [Risk Control Matrix](../standard/risk-control-matrix.md)
-- [Multi-Agent Coordination](../standard/multi-agent-coordination.md)
-- [Source Boundary Contract](../standard/source-boundary-contract.md)
-
-Instrumentation, routing and governance:
-
-- [Development Cockpit](../standard/development-cockpit.md)
-- [Feature Implementation Traceability](../standard/feature-implementation-traceability.md)
-- [Multi-Source Quality Feedback](../standard/multi-source-quality-feedback.md)
-- [Graph As AI Brain](../standard/graph-as-ai-brain.md)
-- [Organization Governance](../standard/organization-governance.md)
-- [Route Explanation](../standard/route-explanation.md)
-- [Routing Fixtures](../standard/routing-fixtures.md)
-- [Route Regression](../standard/route-regression.md)
-- [Federation Health](../standard/federation-health.md)
-- [Test Suite](../standard/test-suite.md)
-
-## Profiles
-
-Release-candidate profiles:
-
-- [Software Specification](../profiles/software-specification/README.md)
-- [Project Management](../profiles/project-management/README.md)
-- [AI Employee](../profiles/ai-employee/README.md)
-- [Character Layer](../profiles/character-layer/README.md)
-- [Skill Runtime](../profiles/skill-runtime/README.md)
-- [Implementation Control](../profiles/implementation-control/README.md)
-- [Organization Governance](../profiles/organization-governance/README.md)
-
-Proposal or experimental profile:
-
-- [Societal Governance](../profiles/societal-governance/README.md)
-
-## Examples, Templates And Playground
-
-- [Templates](../templates/README.md)
-- [Minimal Graph](../examples/minimal-graph/README.md)
-- [Implementation Control](../examples/implementation-control-minimal/README.md)
-- [Process Transition](../examples/process-transition-minimal/README.md)
-- [Technology Quality Feedback](../examples/technology-quality-feedback-minimal/README.md)
-- [Dynamic Episode Minimal Example](../examples/dynamic-episode-minimal/README.md)
-- [Semantic Intent Resolution](../examples/semantic-intent-resolution-minimal/README.md)
-- [Goal Vector Quality Control](../examples/goal-vector-quality-control-minimal/README.md)
-- [Instrumentation Layer](../examples/instrumentation-layer-minimal/README.md)
-- [Organization Governance](../examples/organization-governance-minimal/README.md)
-- [Societal Governance Proposal Example](../examples/societal-governance-minimal/README.md)
-- [Playground](../playground/README.md)
-
-## Research And Evidence
-
-- [Scientific Evidence Package](research/scientific-evidence-package.md)
-- [Evidence Package v0.3](research/evidence-package-v0.3.md)
-- [Practice And Science Program](research/practice-science-program.md)
-- [Baseline Comparison Protocol](research/baseline-comparison-protocol.md)
-- [Limitations And Threats](research/limitations-and-threats.md)
-- [Publications](../publications/README.md)
-
-## Releases And Project Process
-
-- [Roadmap](../ROADMAP.md)
-- [Changelog](../CHANGELOG.md)
-- [Release Process](../releases/README.md)
-- [v1.0.0-rc.6](../releases/1.0.0-rc.6.md)
-- [v1.0.0-rc.5](../releases/1.0.0-rc.5.md)
-- [v1.0.0-rc.4](../releases/1.0.0-rc.4.md)
-- [Contributing](../CONTRIBUTING.md)
-
-## Transfer And Historical Notes
-
-Transfer documents explain how public-safe ideas entered Mirai Graph. They are
-not the primary adoption path for new users:
-
-- [Transfer Notes](transfer/)
-- [Alpha Release Notes](../releases/)