mirai-graph 1.0.0-rc.1

package/releases/README.md

@@ -0,0 +1,114 @@
+# Mirai Graph Release Process
+
+Status: initial public process
+
+## Purpose
+
+This directory records public release notes for Mirai Graph tags.
+
+Release notes must separate:
+
+- what changed;
+- what was validated;
+- what remains limited;
+- which claims are supported by the current evidence.
+
+## Release Notes
+
+- [v1.0.0-rc.1](1.0.0-rc.1.md) - 1.0 release candidate consolidating the
+  public standard, profiles, executable process control, instrumentation,
+  Character Layer, adopter kit and evidence boundaries.
+- [v0.1.0-alpha.9](0.1.0-alpha.9.md) - Mirai Graph naming, repository,
+  package and CLI identity consolidation.
+- [v0.1.0-alpha.10](0.1.0-alpha.10.md) - Adopter Workflow, release-state
+  reporting and self-service starter path.
+- [v0.1.0-alpha.11](0.1.0-alpha.11.md) - Instrumentation release candidate for
+  development cockpits, feature traceability and multi-source quality feedback.
+
+## Release Checklist
+
+Before creating a tag:
+
+1. Move relevant `CHANGELOG.md` entries from `[Unreleased]` to the target
+   version.
+2. Update `package.json` version.
+3. Add `releases/<version>.md`.
+4. Run:
+
+```bash
+npm run release:check
+npm run validate:release-state
+```
+
+5. Run a public-safety scan for private paths and obvious secrets.
+6. Verify `git diff --check`.
+7. Commit release preparation.
+8. Create an annotated tag:
+
+```bash
+git tag -a v<version> -m "Mirai Graph <version>"
+```
+
+9. Push `main` and the tag.
+10. Publish GitHub Release notes using `releases/<version>.md`.
+11. After the GitHub Release exists, run:
+
+```bash
+node packages/cli/mirai-graph.js release state --markdown
+node packages/cli/mirai-graph.js release state --require-github-release --markdown
+```
+
+The release-state report must distinguish GitHub Release state, npm registry
+state and npm authentication state. A missing npm login or pending npm package
+publication is a blocker for npm publish, not permission to expose credentials.
+
+## GitHub Release Notes
+
+GitHub Release notes should use the matching file from this directory.
+
+They should include:
+
+- release type;
+- summary;
+- added or changed artifacts;
+- validation command and expected result;
+- important limitations.
+
+Do not claim:
+
+- peer review;
+- real-world productivity improvement;
+- external validity;
+- runtime safety;
+- universal applicability;
+
+unless the release includes evidence that directly supports that claim.
+
+## Public-Safety Scan
+
+Use a targeted scan over public files before release. Keep local private-path
+and credential patterns outside committed documentation:
+
+```bash
+rg -n "<local-private-path-pattern>|<credential-pattern>|<restricted-data-pattern>" .github README.md ROADMAP.md CHANGELOG.md docs standard schemas benchmarks examples packages profiles pilots publications releases package.json .env.example .gitignore
+```
+
+Review matches manually. Maintainers may add local private-path patterns to
+their own release checklist, but local filesystem paths and exact credential
+patterns should not be embedded in public release notes.
+
+## Version Policy
+
+During alpha:
+
+- patch alpha releases may include schema, CLI, documentation and synthetic
+  evidence changes;
+- release notes must state limitations;
+- tags should not be rewritten after publication.
+
+For `1.0.0-rc.*`:
+
+- the package may be reviewed as a release candidate;
+- release notes must still state limitations and publication boundaries;
+- final `1.0.0` requires a separate tag, GitHub Release and npm publication
+  decision after release-state checks.

package/schemas/baseline-comparison-result.schema.json

@@ -0,0 +1,87 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://mirai-graph.dev/schemas/baseline-comparison-result.schema.json",
+  "title": "Mirai Graph Baseline Comparison Result",
+  "type": "object",
+  "additionalProperties": true,
+  "required": [
+    "schema_version",
+    "id",
+    "public_safety",
+    "comparison_type",
+    "task_id",
+    "baseline",
+    "mirai_graph",
+    "outcome",
+    "limitations",
+    "claim_boundary"
+  ],
+  "properties": {
+    "schema_version": { "type": "string", "minLength": 1 },
+    "id": { "type": "string", "minLength": 1 },
+    "public_safety": { "const": "synthetic_public" },
+    "comparison_type": { "const": "baseline_vs_mirai_graph" },
+    "task_id": { "type": "string", "minLength": 1 },
+    "baseline": {
+      "type": "object",
+      "required": [
+        "context_units",
+        "missed_dependencies",
+        "unsupported_assumptions",
+        "evidence_coverage_percent",
+        "false_progress_claims"
+      ],
+      "properties": {
+        "context_units": { "type": "number", "minimum": 0 },
+        "missed_dependencies": { "type": "number", "minimum": 0 },
+        "unsupported_assumptions": { "type": "number", "minimum": 0 },
+        "evidence_coverage_percent": { "type": "number", "minimum": 0, "maximum": 100 },
+        "false_progress_claims": { "type": "number", "minimum": 0 }
+      }
+    },
+    "mirai_graph": {
+      "type": "object",
+      "required": [
+        "context_units",
+        "missed_dependencies",
+        "unsupported_assumptions",
+        "evidence_coverage_percent",
+        "false_progress_claims"
+      ],
+      "properties": {
+        "context_units": { "type": "number", "minimum": 0 },
+        "missed_dependencies": { "type": "number", "minimum": 0 },
+        "unsupported_assumptions": { "type": "number", "minimum": 0 },
+        "evidence_coverage_percent": { "type": "number", "minimum": 0, "maximum": 100 },
+        "false_progress_claims": { "type": "number", "minimum": 0 }
+      }
+    },
+    "outcome": {
+      "type": "object",
+      "required": [
+        "context_reduction_percent",
+        "improved_metrics",
+        "regressed_metrics",
+        "verdict"
+      ],
+      "properties": {
+        "context_reduction_percent": { "type": "number" },
+        "improved_metrics": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 }
+        },
+        "regressed_metrics": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 }
+        },
+        "verdict": { "type": "string", "minLength": 1 }
+      }
+    },
+    "limitations": {
+      "type": "array",
+      "minItems": 1,
+      "items": { "type": "string", "minLength": 1 }
+    },
+    "claim_boundary": { "type": "string", "minLength": 1 }
+  }
+}

package/schemas/character-layer-integration.schema.json

@@ -0,0 +1,112 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://mirai-graph.dev/schemas/character-layer-integration.schema.json",
+  "title": "Mirai Graph Character Layer Integration",
+  "type": "object",
+  "required": [
+    "schema_version",
+    "profile",
+    "public_safety",
+    "integration_id",
+    "character_package_ref",
+    "ai_employee_links",
+    "process_control_links",
+    "runtime_context_boundary",
+    "required_gates",
+    "evidence_refs",
+    "limitations"
+  ],
+  "properties": {
+    "schema_version": {
+      "type": "string"
+    },
+    "profile": {
+      "const": "character_layer"
+    },
+    "public_safety": {
+      "const": "synthetic_public"
+    },
+    "integration_id": {
+      "type": "string"
+    },
+    "character_package_ref": {
+      "type": "string"
+    },
+    "ai_employee_links": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "required": [
+          "ai_employee_ref",
+          "role_ref",
+          "role_character_profile_ref",
+          "composition_relations"
+        ],
+        "properties": {
+          "ai_employee_ref": { "type": "string" },
+          "role_ref": { "type": "string" },
+          "role_character_profile_ref": { "type": "string" },
+          "composition_relations": {
+            "type": "array",
+            "minItems": 1,
+            "items": { "type": "string" }
+          }
+        },
+        "additionalProperties": true
+      }
+    },
+    "process_control_links": {
+      "type": "object",
+      "required": [
+        "launch_record_ref",
+        "process_control_contract_ref",
+        "technology_quality_feedback_ref",
+        "transition_gate_refs"
+      ],
+      "properties": {
+        "launch_record_ref": { "type": "string" },
+        "process_control_contract_ref": { "type": "string" },
+        "technology_quality_feedback_ref": { "type": "string" },
+        "transition_gate_refs": {
+          "type": "array",
+          "minItems": 1,
+          "items": { "type": "string" }
+        }
+      },
+      "additionalProperties": true
+    },
+    "runtime_context_boundary": {
+      "type": "object",
+      "required": [
+        "generated_context_ref",
+        "reflection_protocol_ref",
+        "authorization_boundary",
+        "canonical_update_boundary"
+      ],
+      "properties": {
+        "generated_context_ref": { "type": "string" },
+        "reflection_protocol_ref": { "type": "string" },
+        "authorization_boundary": { "type": "string" },
+        "canonical_update_boundary": { "type": "string" }
+      },
+      "additionalProperties": true
+    },
+    "required_gates": {
+      "type": "array",
+      "minItems": 1,
+      "items": { "type": "string" }
+    },
+    "evidence_refs": {
+      "type": "array",
+      "minItems": 1,
+      "items": { "type": "string" }
+    },
+    "limitations": {
+      "type": "array",
+      "minItems": 1,
+      "items": { "type": "string" }
+    }
+  },
+  "additionalProperties": true
+}

package/schemas/character-layer-readiness.schema.json

@@ -0,0 +1,73 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://mirai-graph.dev/schemas/character-layer-readiness.schema.json",
+  "title": "Mirai Graph Character Layer Readiness",
+  "type": "object",
+  "required": [
+    "schema_version",
+    "profile",
+    "public_safety",
+    "readiness_id",
+    "target_release_track",
+    "readiness_verdict",
+    "completed_capabilities",
+    "validation_commands",
+    "evidence_refs",
+    "claim_boundaries",
+    "remaining_limits"
+  ],
+  "properties": {
+    "schema_version": { "type": "string" },
+    "profile": { "const": "character_layer" },
+    "public_safety": { "const": "synthetic_public" },
+    "readiness_id": { "type": "string" },
+    "target_release_track": { "type": "string" },
+    "readiness_verdict": {
+      "enum": [
+        "ready_for_1_0_candidate",
+        "needs_hardening",
+        "blocked",
+        "insufficient_evidence"
+      ]
+    },
+    "completed_capabilities": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "required": ["id", "status", "evidence_refs"],
+        "properties": {
+          "id": { "type": "string" },
+          "status": { "enum": ["completed", "partial", "missing"] },
+          "evidence_refs": {
+            "type": "array",
+            "minItems": 1,
+            "items": { "type": "string" }
+          }
+        },
+        "additionalProperties": true
+      }
+    },
+    "validation_commands": {
+      "type": "array",
+      "minItems": 1,
+      "items": { "type": "string" }
+    },
+    "evidence_refs": {
+      "type": "array",
+      "minItems": 1,
+      "items": { "type": "string" }
+    },
+    "claim_boundaries": {
+      "type": "array",
+      "minItems": 1,
+      "items": { "type": "string" }
+    },
+    "remaining_limits": {
+      "type": "array",
+      "minItems": 1,
+      "items": { "type": "string" }
+    }
+  },
+  "additionalProperties": true
+}

package/schemas/context-pack.schema.json

@@ -0,0 +1,137 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://mirai-graph.dev/schemas/context-pack.schema.json",
+  "title": "Mirai Graph Context Pack",
+  "type": "object",
+  "additionalProperties": true,
+  "required": [
+    "id",
+    "task_id",
+    "source_graph",
+    "generated_at",
+    "included_objects",
+    "included_relations",
+    "evidence",
+    "selection",
+    "limitations"
+  ],
+  "properties": {
+    "id": {
+      "type": "string",
+      "minLength": 1
+    },
+    "task_id": {
+      "type": "string",
+      "minLength": 1
+    },
+    "source_graph": {
+      "type": "string",
+      "minLength": 1
+    },
+    "generated_at": {
+      "type": "string",
+      "minLength": 1
+    },
+    "included_objects": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "included_relations": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "evidence": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "selection": {
+      "type": "object",
+      "required": [
+        "method",
+        "task_tokens",
+        "object_explanations",
+        "relation_explanations"
+      ],
+      "additionalProperties": true,
+      "properties": {
+        "method": {
+          "type": "string"
+        },
+        "task_tokens": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "object_explanations": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": ["id", "relevance_score", "reasons"],
+            "additionalProperties": true,
+            "properties": {
+              "id": {
+                "type": "string"
+              },
+              "relevance_score": {
+                "type": "number"
+              },
+              "reasons": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                }
+              }
+            }
+          }
+        },
+        "relation_explanations": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": ["id", "reason", "source", "target"],
+            "additionalProperties": true,
+            "properties": {
+              "id": {
+                "type": "string"
+              },
+              "reason": {
+                "type": "string"
+              },
+              "source": {
+                "type": "string"
+              },
+              "target": {
+                "type": "string"
+              }
+            }
+          }
+        }
+      }
+    },
+    "assumptions": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "omissions": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "limitations": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    }
+  }
+}

package/schemas/development-cockpit.schema.json

@@ -0,0 +1,74 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://mirai-graph.dev/schemas/development-cockpit.schema.json",
+  "title": "Mirai Graph Development Cockpit",
+  "type": "object",
+  "required": [
+    "schema_version",
+    "id",
+    "profile",
+    "public_safety",
+    "subject_ref",
+    "generated_at",
+    "instruments",
+    "readiness",
+    "next_best_action",
+    "blocking_rules",
+    "evidence_refs",
+    "limitations"
+  ],
+  "properties": {
+    "schema_version": { "type": "string" },
+    "id": { "type": "string" },
+    "profile": { "const": "implementation_control" },
+    "public_safety": { "const": "synthetic_public" },
+    "subject_ref": { "type": "string" },
+    "generated_at": { "type": "string" },
+    "instruments": {
+      "type": "array",
+      "minItems": 1,
+      "items": { "$ref": "#/$defs/instrument" }
+    },
+    "readiness": {
+      "type": "object",
+      "required": [
+        "developer_test_readiness",
+        "product_readiness",
+        "production_readiness",
+        "external_user_testing_readiness"
+      ],
+      "additionalProperties": true
+    },
+    "next_best_action": {
+      "type": "object",
+      "required": ["action", "target_cycle", "required_gates", "evidence_refs"],
+      "properties": {
+        "action": { "type": "string" },
+        "target_cycle": { "type": "string" },
+        "required_gates": { "type": "array", "items": { "type": "string" } },
+        "evidence_refs": { "type": "array", "items": { "type": "string" } }
+      },
+      "additionalProperties": true
+    },
+    "blocking_rules": { "type": "array", "items": { "type": "string" } },
+    "evidence_refs": { "type": "array", "items": { "type": "string" } },
+    "limitations": { "type": "array", "items": { "type": "string" } }
+  },
+  "$defs": {
+    "instrument": {
+      "type": "object",
+      "required": ["id", "family", "score", "band", "status", "reason", "evidence_refs"],
+      "properties": {
+        "id": { "type": "string" },
+        "family": { "type": "string" },
+        "score": { "type": "number", "minimum": 0, "maximum": 100 },
+        "band": { "type": "string" },
+        "status": { "type": "string" },
+        "reason": { "type": "string" },
+        "evidence_refs": { "type": "array", "items": { "type": "string" } }
+      },
+      "additionalProperties": true
+    }
+  },
+  "additionalProperties": true
+}

package/schemas/feature-implementation-traceability.schema.json

@@ -0,0 +1,80 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://mirai-graph.dev/schemas/feature-implementation-traceability.schema.json",
+  "title": "Mirai Graph Feature Implementation Traceability",
+  "type": "object",
+  "required": [
+    "schema_version",
+    "id",
+    "profile",
+    "public_safety",
+    "subject_ref",
+    "features",
+    "implementation_mappings",
+    "dependency_mappings",
+    "coverage_summary",
+    "evidence_refs",
+    "limitations"
+  ],
+  "properties": {
+    "schema_version": { "type": "string" },
+    "id": { "type": "string" },
+    "profile": { "const": "implementation_control" },
+    "public_safety": { "const": "synthetic_public" },
+    "subject_ref": { "type": "string" },
+    "features": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "required": ["id", "title", "status", "owner_ref", "evidence_refs"],
+        "properties": {
+          "id": { "type": "string" },
+          "title": { "type": "string" },
+          "status": { "type": "string" },
+          "owner_ref": { "type": "string" },
+          "evidence_refs": { "type": "array", "items": { "type": "string" } }
+        },
+        "additionalProperties": true
+      }
+    },
+    "implementation_mappings": {
+      "type": "array",
+      "minItems": 1,
+      "items": { "$ref": "#/$defs/mapping" }
+    },
+    "dependency_mappings": { "type": "array", "items": { "type": "object" } },
+    "coverage_summary": { "type": "object" },
+    "evidence_refs": { "type": "array", "items": { "type": "string" } },
+    "limitations": { "type": "array", "items": { "type": "string" } }
+  },
+  "$defs": {
+    "mapping": {
+      "type": "object",
+      "required": [
+        "feature_ref",
+        "implementation_refs",
+        "test_refs",
+        "review_refs",
+        "documentation_refs",
+        "evidence_refs",
+        "status",
+        "confidence",
+        "known_gaps"
+      ],
+      "properties": {
+        "feature_ref": { "type": "string" },
+        "implementation_refs": { "type": "array", "items": { "type": "string" } },
+        "test_refs": { "type": "array", "items": { "type": "string" } },
+        "review_refs": { "type": "array", "items": { "type": "string" } },
+        "documentation_refs": { "type": "array", "items": { "type": "string" } },
+        "evidence_refs": { "type": "array", "items": { "type": "string" } },
+        "status": { "type": "string" },
+        "confidence": { "type": "number", "minimum": 0, "maximum": 1 },
+        "known_gaps": { "type": "array", "items": { "type": "string" } }
+      },
+      "additionalProperties": true
+    }
+  },
+  "additionalProperties": true
+}