mirai-graph 1.3.0 → 2.1.0

package/schemas/semantic-intent-resolution.schema.json

@@ -1,151 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://mirai-graph.dev/schemas/semantic-intent-resolution.schema.json",
-  "title": "Mirai Graph Semantic Intent Resolution",
-  "type": "object",
-  "additionalProperties": true,
-  "required": [
-    "schema_version",
-    "id",
-    "user_request",
-    "intent_hypothesis",
-    "confidence",
-    "work_scale",
-    "selected_chain_id",
-    "process_model_id",
-    "owner_role",
-    "required_context_slots",
-    "missing_context_slots",
-    "safe_default_action",
-    "execution_allowed",
-    "evidence_requirements",
-    "canonical_write_allowed"
-  ],
-  "properties": {
-    "schema_version": {
-      "type": "string"
-    },
-    "id": {
-      "type": "string"
-    },
-    "user_request": {
-      "type": "string"
-    },
-    "intent_hypothesis": {
-      "type": "string"
-    },
-    "confidence": {
-      "type": "string",
-      "enum": [
-        "low",
-        "medium",
-        "high"
-      ]
-    },
-    "work_scale": {
-      "type": "string",
-      "enum": [
-        "checkpoint",
-        "batch",
-        "milestone",
-        "goal",
-        "track",
-        "program",
-        "vision",
-        "unspecified"
-      ]
-    },
-    "selected_chain_id": {
-      "type": "string"
-    },
-    "process_model_id": {
-      "type": [
-        "string",
-        "null"
-      ]
-    },
-    "owner_role": {
-      "type": "string"
-    },
-    "companion_roles": {
-      "type": "array",
-      "items": {
-        "type": "string"
-      }
-    },
-    "required_context_slots": {
-      "type": "array",
-      "items": {
-        "type": "string"
-      }
-    },
-    "missing_context_slots": {
-      "type": "array",
-      "items": {
-        "type": "string"
-      }
-    },
-    "clarifying_questions": {
-      "type": "array",
-      "items": {
-        "type": "object"
-      }
-    },
-    "safe_default_action": {
-      "type": "string"
-    },
-    "execution_allowed": {
-      "type": "boolean"
-    },
-    "review_surface_required": {
-      "type": "boolean"
-    },
-    "risk_flags": {
-      "type": "array",
-      "items": {
-        "type": "string",
-        "enum": [
-          "live",
-          "destructive",
-          "access",
-          "data",
-          "git_history",
-          "secret"
-        ]
-      }
-    },
-    "required_gates": {
-      "type": "array",
-      "items": {
-        "type": "string"
-      }
-    },
-    "evidence_requirements": {
-      "type": "array",
-      "items": {
-        "type": "string"
-      }
-    },
-    "dynamic_episode_ref": {
-      "type": [
-        "string",
-        "null"
-      ]
-    },
-    "technology_quality_feedback_ref": {
-      "type": [
-        "string",
-        "null"
-      ]
-    },
-    "canonical_write_allowed": {
-      "const": false
-    },
-    "limitations": {
-      "type": "array",
-      "items": {
-        "type": "string"
-      }
-    }
-  }
-}

package/schemas/source-boundary-contract.schema.json

@@ -1,31 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://mirai-graph.dev/schemas/source-boundary-contract.schema.json",
-  "title": "Mirai Graph Source Boundary Contract",
-  "type": "object",
-  "additionalProperties": true,
-  "required": ["schema_version", "id", "profile", "public_safety", "source_roles", "promotion_rule", "rejected_promotion_targets", "evidence_refs", "limitations"],
-  "properties": {
-    "schema_version": { "type": "string", "minLength": 1 },
-    "id": { "type": "string", "minLength": 1 },
-    "profile": { "const": "implementation_control" },
-    "public_safety": { "const": "synthetic_public" },
-    "source_roles": {
-      "type": "array",
-      "minItems": 1,
-      "items": {
-        "type": "object",
-        "required": ["role", "description", "canonical_write_allowed"],
-        "properties": {
-          "role": { "type": "string", "minLength": 1 },
-          "description": { "type": "string", "minLength": 1 },
-          "canonical_write_allowed": { "type": "boolean" }
-        }
-      }
-    },
-    "promotion_rule": { "type": "string", "minLength": 1 },
-    "rejected_promotion_targets": { "type": "array", "minItems": 1, "items": { "type": "string", "minLength": 1 } },
-    "evidence_refs": { "type": "array", "minItems": 1, "items": { "type": "string", "minLength": 1 } },
-    "limitations": { "type": "array", "items": { "type": "string" } }
-  }
-}

package/schemas/technology-quality-feedback.schema.json

@@ -1,116 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://mirai-graph.dev/schemas/technology-quality-feedback.schema.json",
-  "title": "Mirai Graph Technology Quality Feedback",
-  "type": "object",
-  "additionalProperties": true,
-  "required": [
-    "schema_version",
-    "id",
-    "profile",
-    "public_safety",
-    "technology_ref",
-    "process_id",
-    "launch_record_ref",
-    "work_evidence_refs",
-    "required_steps",
-    "completed_steps",
-    "missing_steps",
-    "review_dimensions",
-    "findings",
-    "feedback_classification",
-    "blocking_findings",
-    "verdict",
-    "next_transition",
-    "kaizen_refs",
-    "evidence_refs",
-    "limitations"
-  ],
-  "properties": {
-    "schema_version": { "type": "string", "minLength": 1 },
-    "id": { "type": "string", "minLength": 1 },
-    "profile": { "const": "implementation_control" },
-    "public_safety": { "const": "synthetic_public" },
-    "technology_ref": { "type": "string", "minLength": 1 },
-    "process_id": { "type": "string", "minLength": 1 },
-    "launch_record_ref": { "type": "string", "minLength": 1 },
-    "work_evidence_refs": {
-      "type": "array",
-      "minItems": 1,
-      "items": { "type": "string", "minLength": 1 }
-    },
-    "required_steps": {
-      "type": "array",
-      "minItems": 1,
-      "items": { "type": "string", "minLength": 1 }
-    },
-    "completed_steps": {
-      "type": "array",
-      "items": { "type": "string", "minLength": 1 }
-    },
-    "missing_steps": {
-      "type": "array",
-      "items": { "type": "string", "minLength": 1 }
-    },
-    "review_dimensions": {
-      "type": "array",
-      "minItems": 1,
-      "items": { "type": "string", "minLength": 1 }
-    },
-    "findings": {
-      "type": "array",
-      "items": {
-        "type": "object",
-        "required": [
-          "id",
-          "dimension",
-          "classification",
-          "severity",
-          "summary",
-          "evidence_refs",
-          "next_route",
-          "blocking"
-        ],
-        "properties": {
-          "id": { "type": "string", "minLength": 1 },
-          "dimension": { "type": "string", "minLength": 1 },
-          "classification": { "type": "string", "minLength": 1 },
-          "severity": { "type": "string", "minLength": 1 },
-          "summary": { "type": "string", "minLength": 1 },
-          "evidence_refs": {
-            "type": "array",
-            "minItems": 1,
-            "items": { "type": "string", "minLength": 1 }
-          },
-          "next_route": { "type": "string", "minLength": 1 },
-          "blocking": { "type": "boolean" }
-        }
-      }
-    },
-    "feedback_classification": {
-      "type": "array",
-      "minItems": 1,
-      "items": { "type": "string", "minLength": 1 }
-    },
-    "blocking_findings": {
-      "type": "array",
-      "items": { "type": "string", "minLength": 1 }
-    },
-    "verdict": { "type": "string", "minLength": 1 },
-    "next_transition": { "type": "string", "minLength": 1 },
-    "kaizen_refs": {
-      "type": "array",
-      "items": { "type": "string", "minLength": 1 }
-    },
-    "evidence_refs": {
-      "type": "array",
-      "minItems": 1,
-      "items": { "type": "string", "minLength": 1 }
-    },
-    "limitations": {
-      "type": "array",
-      "minItems": 1,
-      "items": { "type": "string", "minLength": 1 }
-    }
-  }
-}

package/schemas/work-state-machine.schema.json

@@ -1,34 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://mirai-graph.dev/schemas/work-state-machine.schema.json",
-  "title": "Mirai Graph Work State Machine",
-  "type": "object",
-  "additionalProperties": true,
-  "required": ["schema_version", "id", "profile", "public_safety", "states", "transitions", "false_transition_guards", "evidence_refs", "limitations"],
-  "properties": {
-    "schema_version": { "type": "string", "minLength": 1 },
-    "id": { "type": "string", "minLength": 1 },
-    "profile": { "const": "implementation_control" },
-    "public_safety": { "const": "synthetic_public" },
-    "states": { "type": "array", "minItems": 2, "items": { "type": "string", "minLength": 1 } },
-    "terminal_states": { "type": "array", "items": { "type": "string", "minLength": 1 } },
-    "transitions": {
-      "type": "array",
-      "minItems": 1,
-      "items": {
-        "type": "object",
-        "required": ["from", "to", "requires_evidence"],
-        "properties": {
-          "from": { "type": "string", "minLength": 1 },
-          "to": { "type": "string", "minLength": 1 },
-          "requires_evidence": { "type": "array", "items": { "type": "string", "minLength": 1 } },
-          "requires_launch_record": { "type": "boolean" },
-          "terminal_requires_kaizen": { "type": "boolean" }
-        }
-      }
-    },
-    "false_transition_guards": { "type": "array", "minItems": 1, "items": { "type": "string", "minLength": 1 } },
-    "evidence_refs": { "type": "array", "minItems": 1, "items": { "type": "string", "minLength": 1 } },
-    "limitations": { "type": "array", "items": { "type": "string" } }
-  }
-}

package/standard/action-runtime-boundary.md

@@ -1,99 +0,0 @@
-# Action Runtime Boundary
-
-Status: 1.0 release-candidate standard section
-
-## Purpose
-
-This section defines the boundary between Mirai Graph canonical state and
-action-capable runtime behavior.
-
-The boundary is required for AI employees, automation systems and any
-Mirai Graph implementation that can affect external systems.
-
-## State Sequence
-
-Action-capable implementations should preserve this sequence:
-
-```text
-canonical graph state
--> generated context
--> runtime decision
--> proposed action
--> approval gate
--> executed action
--> audited result
-```
-
-## Canonical Graph State
-
-Canonical graph state is the source of truth for durable objects, relations,
-policies, evidence, readiness and governance records.
-
-It may say that an AI employee has a role, can use a tool or follows a policy.
-It does not prove that a particular runtime action should execute now.
-
-## Generated Context
-
-Generated context is a task-bounded view derived from canonical state.
-
-It helps a human or AI system reason about a task. It is not authorization.
-
-## Runtime Decision
-
-A runtime decision is a transient conclusion produced by an implementation.
-
-It may recommend an action, escalation, delegation or no-op. It should record
-the context, policy and evidence it used.
-
-## Proposed Action
-
-A proposed action describes what the runtime wants to do before execution.
-
-It should include:
-
-- action id;
-- actor;
-- target system or object;
-- required capability;
-- applicable policy;
-- approval requirement;
-- expected result;
-- rollback or recovery note when relevant.
-
-## Approval Gate
-
-An approval gate decides whether a proposed action may execute.
-
-Approval may be automatic for low-risk actions when policy allows it. It should
-be explicit for external, irreversible, sensitive, permission-changing or
-public-facing actions.
-
-## Executed Action
-
-An executed action records that a runtime operation actually happened.
-
-It should not be represented only as an intended task. It needs execution
-evidence, timestamp or version reference, status and actor/runtime identity
-where available.
-
-## Audited Result
-
-An audited result records the observed outcome and whether it matched the
-expected result.
-
-Results may produce feedback, lessons, risks or follow-up actions. They should
-not silently update canonical behavior without a learning gate.
-
-## Minimum Safety Rule
-
-```text
-generated context != authorization
-runtime decision != executed action
-feedback != canonical update
-```
-
-## Implementation Note
-
-Mirai Graph can model this boundary. The runtime implementation remains
-responsible for authentication, authorization, tool sandboxing, retries,
-timeouts, logging, rollback and operational security.

package/standard/adoption-levels.md

@@ -1,69 +0,0 @@
-# Mirai Graph Adoption Levels
-
-Status: 1.0 release-candidate standard section
-
-## Purpose
-
-Mirai Graph adoption is not binary. A repository, project, product, AI employee
-or skill can contain valid graph artifacts without being ready for runtime use
-or source-of-truth migration.
-
-Adoption levels define a staged path from no graph artifacts to a governed
-graph-first source candidate.
-
-## Levels
-
-| Level | Name | Meaning |
-| --- | --- | --- |
-| GGA0 | `not_started` | No Mirai Graph artifacts are present. |
-| GGA1 | `inventoried` | Sources, owner boundaries and target scope are identified. |
-| GGA2 | `seeded` | A Graph Seed exists and validates. |
-| GGA3 | `embryo_reviewable` | Graph Embryo and initial projection views exist. |
-| GGA4 | `scored` | Readiness, quality or control dashboard evidence exists. |
-| GGA5 | `proposal_gated` | Candidate graph changes pass through proposal, review and apply gates. |
-| GGA6 | `semantically_preserved` | Meaning-preservation review passed for the declared scope. |
-| GGA7 | `effectiveness_checked` | Representative tasks show non-regressed or improved operation. |
-| GGA8 | `federation_ready` | Bounded federation export or contract is valid. |
-| GGA9 | `federation_integrated` | The graph participates in a larger graph, skill mesh or service federation. |
-| GGA10 | `graph_first_source_candidate` | A separate decision allows graph-first source planning or dry-run work. |
-
-## Sequential Gate Rule
-
-Later levels should not skip earlier gates. A system should not claim `GGA8`
-if semantic preservation and effectiveness evidence are missing.
-
-`GGA10` does not grant canonical write permission. It only means graph-first
-source planning or dry-run work may start under a separate decision artifact.
-
-## Required Evidence
-
-An adoption report should record:
-
-- target scope;
-- source classes;
-- owner boundary;
-- profile;
-- latest level;
-- level evidence;
-- blockers;
-- next action;
-- gate results;
-- limitations.
-
-## Anti-Claims
-
-Do not claim that a graph is migrated because:
-
-- JSON validates;
-- a seed exists;
-- a context pack was generated;
-- a dashboard is green;
-- a profile conformance fixture passed.
-
-Those are useful signals, not full adoption.
-
-## Limited Claim
-
-Passing a level supports only the claim attached to that level. For example,
-`GGA2` supports the claim that a Graph Seed validates. It does not support a
-claim that the graph preserved domain meaning or improved work.

package/standard/conformance-levels.md

@@ -1,133 +0,0 @@
-# Mirai Graph Conformance Levels
-
-Status: 1.0 release-candidate standard section
-
-## Purpose
-
-Conformance levels describe how completely an implementation follows the
-Mirai Graph standard.
-
-Conformance must be testable. A project should not claim a level without
-evidence, fixtures or validation output.
-
-## Level 0: Terminology Alignment
-
-The implementation uses Mirai Graph terminology consistently but does not yet
-provide a complete canonical graph package.
-
-Expected evidence:
-
-- terminology map;
-- declared deviations;
-- no claim of full implementation.
-
-Useful for:
-
-- early documentation;
-- research discussion;
-- internal planning.
-
-## Level 1: Canonical Graph State
-
-The implementation maintains objects and relations in a structured graph
-package.
-
-Minimum requirements:
-
-- object ids are stable;
-- relation ids are stable;
-- relation source and target resolve to existing objects;
-- readiness values are present;
-- evidence boundaries are explicit;
-- package passes the validator.
-
-Current validator:
-
-```bash
-node packages/cli/validate-mirai-graph.js <package-dir>
-```
-
-Useful for:
-
-- structured specification work;
-- simple examples;
-- early integration pilots.
-
-## Level 2: Context-Pack Generation
-
-The implementation can generate task-specific context packs from canonical
-graph state.
-
-Minimum requirements:
-
-- context pack declares task boundary;
-- included objects and relations are traceable;
-- evidence references are preserved;
-- omitted context is explainable;
-- generated context is not treated as canonical state.
-
-Useful for:
-
-- AI-assisted work;
-- context engineering;
-- task-specific review and implementation.
-
-## Level 3: Governance-Gated Operation
-
-The implementation uses governance gates for accepted graph updates, public
-claims or action-capable workflows.
-
-Minimum requirements:
-
-- governance gates are defined;
-- gate results are recorded;
-- blocked items remain traceable;
-- action-capable workflows separate proposed, authorized and executed action;
-- public claims are evidence-gated.
-
-Useful for:
-
-- organizational workflows;
-- public documentation;
-- safety-sensitive AI-assisted work;
-- product or project governance.
-
-## Level 4: Profiled Multi-Domain Operation
-
-The implementation supports profiles and profile boundaries.
-
-Minimum requirements:
-
-- at least two profiles exist;
-- profile-specific object kinds or relation types are documented;
-- cross-profile conflicts are handled;
-- conformance evidence is recorded per profile;
-- core standard remains stable across profiles.
-
-Useful for:
-
-- multi-project systems;
-- organizational adoption;
-- cross-domain research;
-- public-sector or country-scale conceptual modeling.
-
-## Current Repository Conformance
-
-Current status:
-
-`Level 1 partial`
-
-Evidence:
-
-- minimal graph package validates;
-- synthetic benchmark package validates;
-- schemas and validator exist;
-- standard sections are still incomplete.
-
-Not yet present:
-
-- full context-pack generation standard;
-- governance gate result schema;
-- profile conformance tests;
-- package manifest schema;
-- independent implementation pilot.