mirai-graph 1.3.0 → 2.1.0

package/examples/technology-quality-feedback-minimal/README.md

@@ -1,33 +0,0 @@
-# Technology Quality Feedback Minimal Example
-
-Status: synthetic public example
-
-## Purpose
-
-This example demonstrates a technology quality feedback report as a gate that
-checks whether work followed the declared process before acceptance or release.
-
-It models:
-
-```text
-technology contract
--> launch record
--> work evidence
--> feedback report
--> classified findings
--> transition decision
--> Kaizen route
-```
-
-Passing tests and complete evidence do not equal accepted work. The feedback
-report supports the next transition, but it does not approve release or update
-canonical state.
-
-## Validation
-
-Run:
-
-```bash
-npm run validate:technology-quality-feedback
-npm run test:technology-quality-feedback-negative
-```

package/examples/technology-quality-feedback-minimal/graph/objects.json

@@ -1,56 +0,0 @@
-[
-  {
-    "id": "evidence.synthetic_quality_feedback_brief",
-    "kind": "evidence",
-    "title": "Synthetic Quality Feedback Brief",
-    "summary": "Public-safe evidence describing a synthetic technology quality feedback gate.",
-    "readiness": "accepted",
-    "evidence": [],
-    "profile": "implementation_control"
-  },
-  {
-    "id": "technology.synthetic_control_loop",
-    "kind": "technology_contract",
-    "title": "Synthetic Control Loop Technology",
-    "summary": "Technology contract requiring launch review, bounded work, evidence, semantic review and classified feedback before acceptance.",
-    "readiness": "accepted",
-    "evidence": ["evidence.synthetic_quality_feedback_brief"],
-    "profile": "implementation_control"
-  },
-  {
-    "id": "launch_record.synthetic_quality_batch",
-    "kind": "launch_record",
-    "title": "Synthetic Quality Batch Launch Record",
-    "summary": "Launch record bounding a synthetic work batch and its evidence requirements.",
-    "readiness": "accepted",
-    "evidence": ["evidence.synthetic_quality_feedback_brief"],
-    "profile": "implementation_control"
-  },
-  {
-    "id": "feedback.synthetic_work_batch",
-    "kind": "technology_quality_feedback",
-    "title": "Synthetic Work Batch Technology Feedback",
-    "summary": "Feedback report checking conformance to the declared technology and routing a non-blocking process improvement to Kaizen.",
-    "readiness": "review_ready",
-    "evidence": ["evidence.synthetic_quality_feedback_brief"],
-    "profile": "implementation_control"
-  },
-  {
-    "id": "finding.synthetic_process_improvement",
-    "kind": "quality_finding",
-    "title": "Synthetic Process Improvement Finding",
-    "summary": "Non-blocking finding that improves future validator wording and routes to Kaizen.",
-    "readiness": "review_ready",
-    "evidence": ["evidence.synthetic_quality_feedback_brief"],
-    "profile": "implementation_control"
-  },
-  {
-    "id": "kaizen.synthetic_validator_recipe",
-    "kind": "kaizen_item",
-    "title": "Synthetic Validator Recipe Improvement",
-    "summary": "Kaizen item for improving the reusable validator recipe after the completed cycle.",
-    "readiness": "draft",
-    "evidence": ["evidence.synthetic_quality_feedback_brief"],
-    "profile": "implementation_control"
-  }
-]

package/examples/technology-quality-feedback-minimal/graph/relations.json

@@ -1,47 +0,0 @@
-[
-  {
-    "id": "relation.evidence.synthetic_quality_feedback_brief.evidences.feedback.synthetic_work_batch",
-    "type": "evidences",
-    "source": "evidence.synthetic_quality_feedback_brief",
-    "target": "feedback.synthetic_work_batch",
-    "readiness": "accepted",
-    "evidence": ["evidence.synthetic_quality_feedback_brief"],
-    "profile": "implementation_control"
-  },
-  {
-    "id": "relation.feedback.synthetic_work_batch.checks_conformance_to.technology.synthetic_control_loop",
-    "type": "checks_conformance_to",
-    "source": "feedback.synthetic_work_batch",
-    "target": "technology.synthetic_control_loop",
-    "readiness": "review_ready",
-    "evidence": ["evidence.synthetic_quality_feedback_brief"],
-    "profile": "implementation_control"
-  },
-  {
-    "id": "relation.feedback.synthetic_work_batch.requires_launch_record.launch_record.synthetic_quality_batch",
-    "type": "requires_launch_record",
-    "source": "feedback.synthetic_work_batch",
-    "target": "launch_record.synthetic_quality_batch",
-    "readiness": "accepted",
-    "evidence": ["evidence.synthetic_quality_feedback_brief"],
-    "profile": "implementation_control"
-  },
-  {
-    "id": "relation.feedback.synthetic_work_batch.classifies.finding.synthetic_process_improvement",
-    "type": "classifies",
-    "source": "feedback.synthetic_work_batch",
-    "target": "finding.synthetic_process_improvement",
-    "readiness": "review_ready",
-    "evidence": ["evidence.synthetic_quality_feedback_brief"],
-    "profile": "implementation_control"
-  },
-  {
-    "id": "relation.finding.synthetic_process_improvement.routes_to.kaizen.synthetic_validator_recipe",
-    "type": "routes_to",
-    "source": "finding.synthetic_process_improvement",
-    "target": "kaizen.synthetic_validator_recipe",
-    "readiness": "review_ready",
-    "evidence": ["evidence.synthetic_quality_feedback_brief"],
-    "profile": "implementation_control"
-  }
-]

package/examples/technology-quality-feedback-minimal/graph.json

@@ -1,34 +0,0 @@
-{
-  "$schema": "https://mirai-graph.dev/schemas/graph-manifest.schema.json",
-  "format": "mirai-graph",
-  "schema_version": "2.0.0",
-  "id": "package.technology_quality_feedback_minimal",
-  "aliases": [],
-  "title": "Technology Quality Feedback Minimal",
-  "scope": "package",
-  "kind": "graph_package",
-  "owner": "mirai-graph",
-  "profiles": [
-    "implementation_control"
-  ],
-  "graph": {
-    "root": "graph",
-    "source_of_truth": [
-      "graph"
-    ],
-    "objects": [
-      "graph/objects.json"
-    ],
-    "relations": [
-      "graph/relations.json"
-    ],
-    "schemas": [],
-    "generated": [],
-    "raw_sources": [
-      "README.md"
-    ]
-  },
-  "imports": [],
-  "version": "0.1.0",
-  "conformance_level": "level_1"
-}

package/examples/technology-quality-feedback-minimal/invalid-accepted-with-blocking.json

@@ -1,33 +0,0 @@
-{
-  "schema_version": "0.1.0",
-  "id": "feedback.invalid_blocking",
-  "profile": "implementation_control",
-  "public_safety": "synthetic_public",
-  "technology_ref": "technology.synthetic_control_loop",
-  "process_id": "process.synthetic_quality_feedback",
-  "launch_record_ref": "launch_record.synthetic_quality_batch",
-  "work_evidence_refs": ["evidence.synthetic_tests"],
-  "required_steps": ["launch_record_reviewed"],
-  "completed_steps": ["launch_record_reviewed"],
-  "missing_steps": [],
-  "review_dimensions": ["security"],
-  "findings": [
-    {
-      "id": "finding.blocking_security",
-      "dimension": "security",
-      "classification": "security_blocker",
-      "severity": "critical",
-      "summary": "Blocking security issue remains unresolved.",
-      "evidence_refs": ["evidence.synthetic_tests"],
-      "next_route": "blocked",
-      "blocking": true
-    }
-  ],
-  "feedback_classification": ["security_blocker"],
-  "blocking_findings": ["finding.blocking_security"],
-  "verdict": "accepted",
-  "next_transition": "review_ready->approved_candidate",
-  "kaizen_refs": [],
-  "evidence_refs": ["evidence.synthetic_quality_feedback_brief"],
-  "limitations": ["Passing tests are not acceptance."]
-}

package/examples/technology-quality-feedback-minimal/invalid-evidence-as-authorization.json

@@ -1,22 +0,0 @@
-{
-  "schema_version": "0.1.0",
-  "id": "feedback.invalid_authorization",
-  "profile": "implementation_control",
-  "public_safety": "synthetic_public",
-  "technology_ref": "technology.synthetic_control_loop",
-  "process_id": "process.synthetic_quality_feedback",
-  "launch_record_ref": "launch_record.synthetic_quality_batch",
-  "work_evidence_refs": ["evidence.synthetic_tests"],
-  "required_steps": ["launch_record_reviewed"],
-  "completed_steps": ["launch_record_reviewed"],
-  "missing_steps": [],
-  "review_dimensions": ["evidence"],
-  "findings": [],
-  "feedback_classification": ["accepted"],
-  "blocking_findings": [],
-  "verdict": "accepted",
-  "next_transition": "canonical_update",
-  "kaizen_refs": [],
-  "evidence_refs": ["evidence.synthetic_quality_feedback_brief"],
-  "limitations": ["Evidence is approval."]
-}

package/examples/technology-quality-feedback-minimal/invalid-missing-required-step.json

@@ -1,22 +0,0 @@
-{
-  "schema_version": "0.1.0",
-  "id": "feedback.invalid_missing_step",
-  "profile": "implementation_control",
-  "public_safety": "synthetic_public",
-  "technology_ref": "technology.synthetic_control_loop",
-  "process_id": "process.synthetic_quality_feedback",
-  "launch_record_ref": "launch_record.synthetic_quality_batch",
-  "work_evidence_refs": ["evidence.synthetic_tests"],
-  "required_steps": ["launch_record_reviewed", "semantic_acceptance_reviewed"],
-  "completed_steps": ["launch_record_reviewed"],
-  "missing_steps": ["semantic_acceptance_reviewed"],
-  "review_dimensions": ["evidence"],
-  "findings": [],
-  "feedback_classification": ["accepted"],
-  "blocking_findings": [],
-  "verdict": "accepted",
-  "next_transition": "review_ready->approved_candidate",
-  "kaizen_refs": [],
-  "evidence_refs": ["evidence.synthetic_quality_feedback_brief"],
-  "limitations": ["Evidence does not authorize canonical update."]
-}

package/examples/technology-quality-feedback-minimal/invalid-process-improvement-without-kaizen.json

@@ -1,33 +0,0 @@
-{
-  "schema_version": "0.1.0",
-  "id": "feedback.invalid_process_improvement",
-  "profile": "implementation_control",
-  "public_safety": "synthetic_public",
-  "technology_ref": "technology.synthetic_control_loop",
-  "process_id": "process.synthetic_quality_feedback",
-  "launch_record_ref": "launch_record.synthetic_quality_batch",
-  "work_evidence_refs": ["evidence.synthetic_semantic_review"],
-  "required_steps": ["launch_record_reviewed"],
-  "completed_steps": ["launch_record_reviewed"],
-  "missing_steps": [],
-  "review_dimensions": ["process_adherence"],
-  "findings": [
-    {
-      "id": "finding.process_gap",
-      "dimension": "process_adherence",
-      "classification": "process_improvement",
-      "severity": "medium",
-      "summary": "The process can be improved, but no Kaizen route is recorded.",
-      "evidence_refs": ["evidence.synthetic_semantic_review"],
-      "next_route": "defer",
-      "blocking": false
-    }
-  ],
-  "feedback_classification": ["process_improvement"],
-  "blocking_findings": [],
-  "verdict": "accepted_with_deferred_items",
-  "next_transition": "review_ready->approved_candidate",
-  "kaizen_refs": [],
-  "evidence_refs": ["evidence.synthetic_quality_feedback_brief"],
-  "limitations": ["Technology quality feedback supports acceptance but is not acceptance by itself."]
-}

package/examples/technology-quality-feedback-minimal/invalid-spec-gap-without-route.json

@@ -1,33 +0,0 @@
-{
-  "schema_version": "0.1.0",
-  "id": "feedback.invalid_spec_gap",
-  "profile": "implementation_control",
-  "public_safety": "synthetic_public",
-  "technology_ref": "technology.synthetic_control_loop",
-  "process_id": "process.synthetic_quality_feedback",
-  "launch_record_ref": "launch_record.synthetic_quality_batch",
-  "work_evidence_refs": ["evidence.synthetic_semantic_review"],
-  "required_steps": ["launch_record_reviewed"],
-  "completed_steps": ["launch_record_reviewed"],
-  "missing_steps": [],
-  "review_dimensions": ["graph_drift"],
-  "findings": [
-    {
-      "id": "finding.spec_gap",
-      "dimension": "graph_drift",
-      "classification": "spec_gap",
-      "severity": "medium",
-      "summary": "A specification gap is recorded, but it is not routed back to planning or graph sync.",
-      "evidence_refs": ["evidence.synthetic_semantic_review"],
-      "next_route": "continue_transition_review",
-      "blocking": false
-    }
-  ],
-  "feedback_classification": ["spec_gap"],
-  "blocking_findings": [],
-  "verdict": "accepted_with_deferred_items",
-  "next_transition": "review_ready->approved_candidate",
-  "kaizen_refs": [],
-  "evidence_refs": ["evidence.synthetic_quality_feedback_brief"],
-  "limitations": ["Generated context and proposals do not mutate canonical state."]
-}

package/examples/technology-quality-feedback-minimal/invalid-unclassified-finding.json

@@ -1,33 +0,0 @@
-{
-  "schema_version": "0.1.0",
-  "id": "feedback.invalid_unclassified",
-  "profile": "implementation_control",
-  "public_safety": "synthetic_public",
-  "technology_ref": "technology.synthetic_control_loop",
-  "process_id": "process.synthetic_quality_feedback",
-  "launch_record_ref": "launch_record.synthetic_quality_batch",
-  "work_evidence_refs": ["evidence.synthetic_tests"],
-  "required_steps": ["launch_record_reviewed"],
-  "completed_steps": ["launch_record_reviewed"],
-  "missing_steps": [],
-  "review_dimensions": ["tests"],
-  "findings": [
-    {
-      "id": "finding.unclassified",
-      "dimension": "tests",
-      "classification": "needs_attention",
-      "severity": "medium",
-      "summary": "Finding uses a non-standard classification.",
-      "evidence_refs": ["evidence.synthetic_tests"],
-      "next_route": "continue_transition_review",
-      "blocking": false
-    }
-  ],
-  "feedback_classification": ["accepted"],
-  "blocking_findings": [],
-  "verdict": "accepted",
-  "next_transition": "review_ready->approved_candidate",
-  "kaizen_refs": [],
-  "evidence_refs": ["evidence.synthetic_quality_feedback_brief"],
-  "limitations": ["Passing tests are not acceptance."]
-}

package/examples/technology-quality-feedback-minimal/results/technology-quality-feedback.json

@@ -1,80 +0,0 @@
-{
-  "schema_version": "0.1.0",
-  "id": "feedback.synthetic_work_batch",
-  "profile": "implementation_control",
-  "public_safety": "synthetic_public",
-  "technology_ref": "technology.synthetic_control_loop",
-  "process_id": "process.synthetic_quality_feedback",
-  "launch_record_ref": "launch_record.synthetic_quality_batch",
-  "work_evidence_refs": [
-    "evidence.synthetic_scope_check",
-    "evidence.synthetic_tests",
-    "evidence.synthetic_semantic_review"
-  ],
-  "required_steps": [
-    "launch_record_reviewed",
-    "scope_boundary_checked",
-    "tests_recorded",
-    "semantic_acceptance_reviewed",
-    "technology_feedback_recorded"
-  ],
-  "completed_steps": [
-    "launch_record_reviewed",
-    "scope_boundary_checked",
-    "tests_recorded",
-    "semantic_acceptance_reviewed",
-    "technology_feedback_recorded"
-  ],
-  "missing_steps": [],
-  "review_dimensions": [
-    "scope",
-    "architecture",
-    "ownership",
-    "tests",
-    "evidence",
-    "graph_drift",
-    "release",
-    "process_adherence"
-  ],
-  "findings": [
-    {
-      "id": "finding.synthetic_tests_not_acceptance",
-      "dimension": "tests",
-      "classification": "accepted",
-      "severity": "low",
-      "summary": "Tests are present and useful evidence, but the report keeps them separate from acceptance.",
-      "evidence_refs": ["evidence.synthetic_tests"],
-      "next_route": "continue_transition_review",
-      "blocking": false
-    },
-    {
-      "id": "finding.synthetic_process_improvement",
-      "dimension": "process_adherence",
-      "classification": "process_improvement",
-      "severity": "low",
-      "summary": "Future batches should include a shorter reusable checklist for technology-feedback preparation.",
-      "evidence_refs": ["evidence.synthetic_semantic_review"],
-      "next_route": "kaizen_improvement",
-      "blocking": false
-    }
-  ],
-  "feedback_classification": [
-    "accepted",
-    "process_improvement"
-  ],
-  "blocking_findings": [],
-  "verdict": "accepted_with_deferred_items",
-  "next_transition": "review_ready->approved_candidate",
-  "kaizen_refs": [
-    "kaizen.synthetic_validator_recipe"
-  ],
-  "evidence_refs": [
-    "evidence.synthetic_quality_feedback_brief"
-  ],
-  "limitations": [
-    "Synthetic feedback demonstrates process conformance shape, not real-world safety.",
-    "Passing tests are not acceptance.",
-    "Evidence does not authorize canonical update.",
-    "Technology quality feedback supports acceptance but is not acceptance by itself."
-  ]
-}

package/examples/work-recovery-minimal/README.md

@@ -1,15 +0,0 @@
-# Work Recovery Minimal Example
-
-Status: synthetic public example
-
-## Purpose
-
-This example shows a governed work state machine and a durable recovery record.
-
-## Validation
-
-Run:
-
-```bash
-npm run validate:work-state
-```

package/examples/work-recovery-minimal/graph/objects.json

@@ -1,47 +0,0 @@
-[
-  {
-    "id": "evidence.synthetic_work_brief",
-    "kind": "evidence",
-    "title": "Synthetic Work Brief",
-    "summary": "Public-safe brief for work state and recovery.",
-    "readiness": "accepted",
-    "evidence": [],
-    "profile": "implementation_control"
-  },
-  {
-    "id": "machine.review_work_state",
-    "kind": "work_state_machine",
-    "title": "Review Work State Machine",
-    "summary": "Synthetic state machine for governed review work.",
-    "readiness": "accepted",
-    "evidence": ["evidence.synthetic_work_brief"],
-    "profile": "implementation_control"
-  },
-  {
-    "id": "state.ready_to_execute",
-    "kind": "work_state",
-    "title": "Ready To Execute",
-    "summary": "Launch-ready state that is not execution itself.",
-    "readiness": "accepted",
-    "evidence": ["evidence.synthetic_work_brief"],
-    "profile": "implementation_control"
-  },
-  {
-    "id": "state.evidence_recorded",
-    "kind": "work_state",
-    "title": "Evidence Recorded",
-    "summary": "Evidence has been recorded for review, but approval is still separate.",
-    "readiness": "review_ready",
-    "evidence": ["evidence.synthetic_work_brief"],
-    "profile": "implementation_control"
-  },
-  {
-    "id": "recovery.review_work_resume",
-    "kind": "recovery_record",
-    "title": "Review Work Resume Record",
-    "summary": "Durable resume record for interrupted synthetic review work.",
-    "readiness": "review_ready",
-    "evidence": ["evidence.synthetic_work_brief"],
-    "profile": "implementation_control"
-  }
-]

package/examples/work-recovery-minimal/graph/relations.json

@@ -1,20 +0,0 @@
-[
-  {
-    "id": "relation.state.ready_to_execute.transitions_to.state.evidence_recorded",
-    "type": "transitions_to",
-    "source": "state.ready_to_execute",
-    "target": "state.evidence_recorded",
-    "readiness": "review_ready",
-    "evidence": ["evidence.synthetic_work_brief"],
-    "profile": "implementation_control"
-  },
-  {
-    "id": "relation.recovery.review_work_resume.resumes_from.state.evidence_recorded",
-    "type": "resumes_from",
-    "source": "recovery.review_work_resume",
-    "target": "state.evidence_recorded",
-    "readiness": "review_ready",
-    "evidence": ["evidence.synthetic_work_brief"],
-    "profile": "implementation_control"
-  }
-]

package/examples/work-recovery-minimal/graph.json

@@ -1,37 +0,0 @@
-{
-  "$schema": "https://mirai-graph.dev/schemas/graph-manifest.schema.json",
-  "format": "mirai-graph",
-  "schema_version": "2.0.0",
-  "id": "package.work_recovery_minimal",
-  "aliases": [],
-  "title": "Work Recovery Minimal",
-  "scope": "package",
-  "kind": "graph_package",
-  "owner": "mirai-graph",
-  "profiles": [
-    "implementation_control"
-  ],
-  "graph": {
-    "root": "graph",
-    "source_of_truth": [
-      "graph"
-    ],
-    "objects": [
-      "graph/objects.json"
-    ],
-    "relations": [
-      "graph/relations.json"
-    ],
-    "schemas": [],
-    "generated": [],
-    "raw_sources": [
-      "README.md"
-    ]
-  },
-  "imports": [],
-  "version": "0.1.0",
-  "conformance_level": "level_1",
-  "description": "Synthetic package showing work state and recovery records.",
-  "license": "CC-BY-4.0",
-  "public_safety": "synthetic_public"
-}

package/examples/work-recovery-minimal/results/recovery-resume-record.json

@@ -1,17 +0,0 @@
-{
-  "schema_version": "0.1.0",
-  "id": "recovery_resume.synthetic_review",
-  "profile": "implementation_control",
-  "public_safety": "synthetic_public",
-  "current_state": "evidence_recorded",
-  "last_good_checkpoint": "checkpoint.synthetic_review.evidence_recorded",
-  "target_scope": "synthetic review batch",
-  "last_validation_result": "passed_with_notes",
-  "evidence_status": "recorded",
-  "blockers": [],
-  "next_safe_command": "rerun synthetic validation",
-  "rollback_option": "return to launch_ready state",
-  "human_confirmation_required": false,
-  "evidence_refs": ["evidence.synthetic_work_brief"],
-  "limitations": ["Resume record is synthetic and does not reference a real repository."]
-}

package/examples/work-recovery-minimal/results/work-state-machine.json

@@ -1,21 +0,0 @@
-{
-  "schema_version": "0.1.0",
-  "id": "work_state_machine.synthetic_review",
-  "profile": "implementation_control",
-  "public_safety": "synthetic_public",
-  "states": ["planned", "launch_ready", "ready_to_execute", "started", "written", "tests_recorded", "evidence_recorded", "sync_proposed", "review_ready", "approved", "released", "feedback_recorded", "evolution_proposed", "blocked", "paused", "superseded", "recovered"],
-  "transitions": [
-    { "from": "planned", "to": "launch_ready", "requires_evidence": ["plan"] },
-    { "from": "launch_ready", "to": "ready_to_execute", "requires_evidence": ["launch_gate"] },
-    { "from": "ready_to_execute", "to": "started", "requires_evidence": ["scope_check"] },
-    { "from": "evidence_recorded", "to": "sync_proposed", "requires_evidence": ["evidence_pack"] },
-    { "from": "sync_proposed", "to": "approved", "requires_evidence": ["approval_gate"] }
-  ],
-  "false_transition_guards": [
-    "ready_to_execute_is_not_started",
-    "written_is_not_implemented",
-    "sync_proposed_is_not_canonical_update"
-  ],
-  "evidence_refs": ["evidence.synthetic_work_brief"],
-  "limitations": ["Synthetic state machine validates shape, not execution quality."]
-}