{ "phase_id": "phase-02", "category_id": "architecture_engineering_core", "doc_id": "canonical_matrix_v1", "source_path": "/home/yeff/public_html/devon/panel/data/canonical_matrix_v1.json", "documentation_branch_status": "CUSTOM_BRANCH", "bucket_statuses_from_docs_index": { "Prerequisites": "ACTIVE", "Installation": "ACTIVE", "Configuration": "ACTIVE", "Validation": "ACTIVE", "Observable Evidence": "ACTIVE", "Failure Modes & Recovery": "ACTIVE", "Completion & Promotion": "ACTIVE" }, "exported_at": "2026-04-28T05:56:48.644291+00:00", "export_rule": "docs/json export generated from real panel/data source plus docs/index.php branch evidence; no authored content invented by export patch", "source_payload": { "canon_meta": { "canon_id": "devon-canonical-matrix", "version": "1.0.0", "status": "ACTIVE", "matrix_mode": "deployment_order", "source_files": [ "00_project_scope_canonical.yaml", "01_deployment_order_canonical.yaml", "02_panel_canonical_tree.yaml", "03_card_contract_minimums.yaml", "04_memory_canonical_architecture.yaml", "05_server_registry_canonical.yaml", "06_sandbox_environment_canonical.yaml", "07_subcategory_pipelines.yaml" ] }, "matrix": [ { "matrix_id": "MX-001", "deployment_order": 10, "deployment_stage": "host_readiness", "section_id": "S00", "card_id": "core-host-readiness", "display_name": "Host Readiness", "subcategory": "filesystem", "objective": "validate writable canonical filesystem", "hard_dependencies": [], "blockers": [ "filesystem_unwritable" ], "evidence_expected": [ "canonical_directories_exist", "canonical_directories_writable" ], "checks": [ "path_exists_check", "write_probe_check" ], "pipeline_ref": "host_readiness", "contract_ref": "03_card_contract_minimums.yaml", "status_initial": "PASS" }, { "matrix_id": "MX-002", "deployment_order": 10, "deployment_stage": "host_readiness", "section_id": "S00", "card_id": "core-host-readiness", "display_name": "Host Readiness", "subcategory": "root_context", "objective": "validate privileged operational context", "hard_dependencies": [], "blockers": [ "missing_root_access_when_required" ], "evidence_expected": [ "root_shell_access" ], "checks": [ "whoami_check" ], "pipeline_ref": "host_readiness", "contract_ref": "03_card_contract_minimums.yaml", "status_initial": "PASS" }, { "matrix_id": "MX-003", "deployment_order": 10, "deployment_stage": "host_readiness", "section_id": "S00", "card_id": "core-host-readiness", "display_name": "Host Readiness", "subcategory": "python_runtime", "objective": "validate python3 runtime presence", "hard_dependencies": [], "blockers": [ "missing_python3" ], "evidence_expected": [ "python3_binary", "python3_version_output" ], "checks": [ "python3_version_check" ], "pipeline_ref": "host_readiness", "contract_ref": "03_card_contract_minimums.yaml", "status_initial": "PASS" }, { "matrix_id": "MX-004", "deployment_order": 10, "deployment_stage": "host_readiness", "section_id": "S00", "card_id": "core-host-readiness", "display_name": "Host Readiness", "subcategory": "git_runtime", "objective": "validate git runtime presence", "hard_dependencies": [], "blockers": [ "missing_git" ], "evidence_expected": [ "git_binary", "git_version_output" ], "checks": [ "git_version_check" ], "pipeline_ref": "host_readiness", "contract_ref": "03_card_contract_minimums.yaml", "status_initial": "PASS" }, { "matrix_id": "MX-005", "deployment_order": 10, "deployment_stage": "host_readiness", "section_id": "S00", "card_id": "core-host-readiness", "display_name": "Host Readiness", "subcategory": "docker_runtime", "objective": "validate container runtime presence", "hard_dependencies": [], "blockers": [ "missing_container_runtime" ], "evidence_expected": [ "docker_binary", "docker_version_output" ], "checks": [ "docker_version_check" ], "pipeline_ref": "host_readiness", "contract_ref": "03_card_contract_minimums.yaml", "status_initial": "MISSING" }, { "matrix_id": "MX-010", "deployment_order": 20, "deployment_stage": "canon_control_plane", "section_id": "S01", "card_id": "project-scope", "display_name": "Project Scope", "subcategory": "mission", "objective": "define global project scope", "hard_dependencies": [ "MX-001" ], "blockers": [ "missing_scope_file" ], "evidence_expected": [ "/opt/devon/canon/00_project_scope_canonical.yaml" ], "checks": [ "file_exists_check", "yaml_header_check" ], "pipeline_ref": "canon_control_plane", "contract_ref": "03_card_contract_minimums.yaml", "status_initial": "PASS" }, { "matrix_id": "MX-011", "deployment_order": 20, "deployment_stage": "canon_control_plane", "section_id": "S01", "card_id": "deployment-order", "display_name": "Deployment Order", "subcategory": "stages", "objective": "define official operational deployment sequence", "hard_dependencies": [ "MX-010" ], "blockers": [ "missing_deployment_order_file" ], "evidence_expected": [ "/opt/devon/canon/01_deployment_order_canonical.yaml" ], "checks": [ "file_exists_check", "stage_order_check" ], "pipeline_ref": "canon_control_plane", "contract_ref": "03_card_contract_minimums.yaml", "status_initial": "PASS" }, { "matrix_id": "MX-012", "deployment_order": 20, "deployment_stage": "canon_control_plane", "section_id": "S01", "card_id": "card-contracts", "display_name": "Card Contracts", "subcategory": "required_blocks", "objective": "define minimum contract schema for every card", "hard_dependencies": [ "MX-010" ], "blockers": [ "missing_contract_schema" ], "evidence_expected": [ "/opt/devon/canon/03_card_contract_minimums.yaml" ], "checks": [ "file_exists_check", "required_blocks_check" ], "pipeline_ref": "canon_control_plane", "contract_ref": "03_card_contract_minimums.yaml", "status_initial": "PASS" }, { "matrix_id": "MX-020", "deployment_order": 30, "deployment_stage": "server_registry", "section_id": "S02", "card_id": "server-registry", "display_name": "Server Registry", "subcategory": "control_plane", "objective": "register Devon as canonical control plane", "hard_dependencies": [ "MX-011" ], "blockers": [ "missing_server_registry" ], "evidence_expected": [ "/opt/devon/canon/05_server_registry_canonical.yaml" ], "checks": [ "file_exists_check", "control_plane_node_check" ], "pipeline_ref": "server_registry", "contract_ref": "03_card_contract_minimums.yaml", "status_initial": "PASS" }, { "matrix_id": "MX-021", "deployment_order": 30, "deployment_stage": "server_registry", "section_id": "S02", "card_id": "server-registry", "display_name": "Server Registry", "subcategory": "sandbox_hosts", "objective": "define sandbox host model", "hard_dependencies": [ "MX-020" ], "blockers": [ "missing_sandbox_host_definition" ], "evidence_expected": [ "dedicated_sandbox_host_hypothesis" ], "checks": [ "future_hypothesis_check" ], "pipeline_ref": "server_registry", "contract_ref": "03_card_contract_minimums.yaml", "status_initial": "PASS" }, { "matrix_id": "MX-030", "deployment_order": 40, "deployment_stage": "foundation_infrastructure", "section_id": "S03", "card_id": "infrastructure", "display_name": "Infrastructure", "subcategory": "containers", "objective": "enable base container runtime", "hard_dependencies": [ "MX-020", "MX-005" ], "blockers": [ "missing_container_runtime" ], "evidence_expected": [ "docker_binary", "compose_runtime" ], "checks": [ "docker_version_check", "docker_ps_check" ], "pipeline_ref": "foundation_infrastructure", "contract_ref": "03_card_contract_minimums.yaml", "status_initial": "MISSING" }, { "matrix_id": "MX-031", "deployment_order": 50, "deployment_stage": "storage_state", "section_id": "S03", "card_id": "storage-state", "display_name": "Storage & State", "subcategory": "structured_state", "objective": "define structured persistence backend", "hard_dependencies": [ "MX-030" ], "blockers": [ "missing_structured_state_backend" ], "evidence_expected": [ "db_runtime", "db_connectivity" ], "checks": [ "backend_presence_check", "read_write_probe_check" ], "pipeline_ref": "storage_state", "contract_ref": "03_card_contract_minimums.yaml", "status_initial": "MISSING" }, { "matrix_id": "MX-040", "deployment_order": 60, "deployment_stage": "memory_control_plane", "section_id": "S04", "card_id": "memory-manager", "display_name": "Memory Manager", "subcategory": "control_plane", "objective": "establish memory control plane", "hard_dependencies": [ "MX-031" ], "blockers": [ "missing_memory_control_plane" ], "evidence_expected": [ "/opt/devon/canon/04_memory_canonical_architecture.yaml", "router_runtime", "partition_registry_runtime" ], "checks": [ "file_exists_check", "memory_router_presence_check" ], "pipeline_ref": "memory_control_plane", "contract_ref": "03_card_contract_minimums.yaml", "status_initial": "MISSING" }, { "matrix_id": "MX-050", "deployment_order": 70, "deployment_stage": "core_runtime", "section_id": "S05", "card_id": "core-runtime", "display_name": "Core Runtime", "subcategory": "api_runtime", "objective": "enable Devon application runtime", "hard_dependencies": [ "MX-040" ], "blockers": [ "missing_entrypoint", "invalid_env" ], "evidence_expected": [ "app_entrypoint", "api_runtime_process", "health_endpoint" ], "checks": [ "boot_check", "health_endpoint_check" ], "pipeline_ref": "core_runtime", "contract_ref": "03_card_contract_minimums.yaml", "status_initial": "MISSING" }, { "matrix_id": "MX-060", "deployment_order": 80, "deployment_stage": "observability_audit_base", "section_id": "S06", "card_id": "observability-audit", "display_name": "Observability & Audit", "subcategory": "logs", "objective": "enable structured logs and evidence sinks", "hard_dependencies": [ "MX-050" ], "blockers": [ "missing_log_sink" ], "evidence_expected": [ "log_output", "writable_log_path" ], "checks": [ "log_emit_check", "path_write_check" ], "pipeline_ref": "observability_audit_base", "contract_ref": "03_card_contract_minimums.yaml", "status_initial": "MISSING" }, { "matrix_id": "MX-070", "deployment_order": 90, "deployment_stage": "remote_access_orchestration", "section_id": "S07", "card_id": "remote-orchestration", "display_name": "Remote Orchestration", "subcategory": "ssh_profiles", "objective": "define SSH access policy for first-party nodes", "hard_dependencies": [ "MX-020", "MX-060" ], "blockers": [ "missing_ssh_profiles" ], "evidence_expected": [ "ssh_profile_registry" ], "checks": [ "ssh_profile_check" ], "pipeline_ref": "remote_access_orchestration", "contract_ref": "03_card_contract_minimums.yaml", "status_initial": "MISSING" }, { "matrix_id": "MX-080", "deployment_order": 100, "deployment_stage": "sandbox_orchestration", "section_id": "S07", "card_id": "sandbox-environments", "display_name": "Sandbox Environments", "subcategory": "mirror_strategy", "objective": "define project mirroring into sandbox", "hard_dependencies": [ "MX-070", "MX-031" ], "blockers": [ "missing_sandbox_strategy" ], "evidence_expected": [ "/opt/devon/canon/06_sandbox_environment_canonical.yaml", "mirror_strategy_definition" ], "checks": [ "file_exists_check", "mirror_strategy_check" ], "pipeline_ref": "sandbox_orchestration", "contract_ref": "03_card_contract_minimums.yaml", "status_initial": "PASS" }, { "matrix_id": "MX-090", "deployment_order": 110, "deployment_stage": "cognition_base", "section_id": "S08", "card_id": "embeddings", "display_name": "Embeddings", "subcategory": "embedding_model", "objective": "enable embeddings backend", "hard_dependencies": [ "MX-050", "MX-040" ], "blockers": [ "missing_model_registry", "missing_embedding_runtime" ], "evidence_expected": [ "embedding_model", "embedding_inference" ], "checks": [ "model_load_check", "encode_probe_check" ], "pipeline_ref": "cognition_base", "contract_ref": "03_card_contract_minimums.yaml", "status_initial": "MISSING" }, { "matrix_id": "MX-100", "deployment_order": 120, "deployment_stage": "engineering_modules", "section_id": "S09", "card_id": "architect", "display_name": "Architect", "subcategory": "system_design", "objective": "enable architecture planning module", "hard_dependencies": [ "MX-080", "MX-090" ], "blockers": [ "missing_module_runtime", "missing_module_contract" ], "evidence_expected": [ "architect_module", "architect_contract" ], "checks": [ "module_presence_check", "contract_check" ], "pipeline_ref": "engineering_modules", "contract_ref": "03_card_contract_minimums.yaml", "status_initial": "MISSING" }, { "matrix_id": "MX-101", "deployment_order": 120, "deployment_stage": "engineering_modules", "section_id": "S09", "card_id": "planner", "display_name": "Planner", "subcategory": "execution_plan", "objective": "enable execution planning module", "hard_dependencies": [ "MX-100" ], "blockers": [ "missing_module_runtime" ], "evidence_expected": [ "planner_module", "planner_contract" ], "checks": [ "module_presence_check", "contract_check" ], "pipeline_ref": "engineering_modules", "contract_ref": "03_card_contract_minimums.yaml", "status_initial": "MISSING" }, { "matrix_id": "MX-102", "deployment_order": 120, "deployment_stage": "engineering_modules", "section_id": "S09", "card_id": "generator", "display_name": "Generator", "subcategory": "patch_generation", "objective": "enable controlled artifact generation", "hard_dependencies": [ "MX-101" ], "blockers": [ "missing_generation_runtime" ], "evidence_expected": [ "generator_module", "generation_contract" ], "checks": [ "module_presence_check", "generation_probe_check" ], "pipeline_ref": "engineering_modules", "contract_ref": "03_card_contract_minimums.yaml", "status_initial": "MISSING" }, { "matrix_id": "MX-103", "deployment_order": 120, "deployment_stage": "engineering_modules", "section_id": "S09", "card_id": "canonizer", "display_name": "Canonizer", "subcategory": "structure_canon", "objective": "normalize outputs to canonical structure", "hard_dependencies": [ "MX-102" ], "blockers": [ "missing_canonizer_runtime" ], "evidence_expected": [ "canonizer_module" ], "checks": [ "module_presence_check" ], "pipeline_ref": "engineering_modules", "contract_ref": "03_card_contract_minimums.yaml", "status_initial": "MISSING" }, { "matrix_id": "MX-104", "deployment_order": 120, "deployment_stage": "engineering_modules", "section_id": "S09", "card_id": "validator-ci", "display_name": "Validator / CI", "subcategory": "functional_validation", "objective": "validate generated artifacts and runtime behavior", "hard_dependencies": [ "MX-103" ], "blockers": [ "missing_validator_suite" ], "evidence_expected": [ "validator_module", "validator_suite" ], "checks": [ "suite_presence_check", "validation_run_check" ], "pipeline_ref": "engineering_modules", "contract_ref": "03_card_contract_minimums.yaml", "status_initial": "MISSING" }, { "matrix_id": "MX-105", "deployment_order": 120, "deployment_stage": "engineering_modules", "section_id": "S09", "card_id": "executor", "display_name": "Executor", "subcategory": "safe_execution", "objective": "execute approved actions safely", "hard_dependencies": [ "MX-104", "MX-080" ], "blockers": [ "missing_executor_runtime", "missing_execution_policy" ], "evidence_expected": [ "executor_module", "execution_policy" ], "checks": [ "module_presence_check", "sandbox_execution_probe" ], "pipeline_ref": "engineering_modules", "contract_ref": "03_card_contract_minimums.yaml", "status_initial": "MISSING" }, { "matrix_id": "MX-106", "deployment_order": 120, "deployment_stage": "engineering_modules", "section_id": "S09", "card_id": "artifact-canon-layer", "display_name": "Artifact Canon Layer", "subcategory": "artifact_registry", "objective": "register artifacts and provenance", "hard_dependencies": [ "MX-102" ], "blockers": [ "missing_artifact_registry" ], "evidence_expected": [ "artifact_registry_runtime" ], "checks": [ "registry_presence_check" ], "pipeline_ref": "engineering_modules", "contract_ref": "03_card_contract_minimums.yaml", "status_initial": "MISSING" }, { "matrix_id": "MX-107", "deployment_order": 120, "deployment_stage": "engineering_modules", "section_id": "S09", "card_id": "skill-registry", "display_name": "Skill Registry", "subcategory": "skills_index", "objective": "index skills and eligibility rules", "hard_dependencies": [ "MX-104" ], "blockers": [ "missing_skill_registry" ], "evidence_expected": [ "skill_registry_runtime" ], "checks": [ "registry_presence_check" ], "pipeline_ref": "engineering_modules", "contract_ref": "03_card_contract_minimums.yaml", "status_initial": "MISSING" }, { "matrix_id": "MX-110", "deployment_order": 130, "deployment_stage": "governance_policy", "section_id": "S10", "card_id": "policy-governance", "display_name": "Policy & Governance", "subcategory": "policy_rules", "objective": "enforce operational rules and scope", "hard_dependencies": [ "MX-105", "MX-060" ], "blockers": [ "missing_policy_engine" ], "evidence_expected": [ "policy_ruleset", "policy_runtime" ], "checks": [ "policy_load_check", "scope_enforcement_check" ], "pipeline_ref": "governance_policy", "contract_ref": "03_card_contract_minimums.yaml", "status_initial": "MISSING" }, { "matrix_id": "MX-111", "deployment_order": 130, "deployment_stage": "governance_policy", "section_id": "S10", "card_id": "self-monitoring", "display_name": "Self-Monitoring", "subcategory": "state_watch", "objective": "watch internal state and regressions", "hard_dependencies": [ "MX-110" ], "blockers": [ "missing_monitor_runtime" ], "evidence_expected": [ "self_monitor_runtime" ], "checks": [ "runtime_presence_check" ], "pipeline_ref": "governance_policy", "contract_ref": "03_card_contract_minimums.yaml", "status_initial": "MISSING" }, { "matrix_id": "MX-120", "deployment_order": 140, "deployment_stage": "benchmark_learning", "section_id": "S11", "card_id": "benchmark-runner", "display_name": "Benchmark Runner", "subcategory": "test_suites", "objective": "run benchmark suites and record scores", "hard_dependencies": [ "MX-104", "MX-110" ], "blockers": [ "missing_benchmark_harness" ], "evidence_expected": [ "benchmark_runner_runtime", "baseline_registry" ], "checks": [ "runtime_presence_check", "benchmark_probe_check" ], "pipeline_ref": "benchmark_learning", "contract_ref": "03_card_contract_minimums.yaml", "status_initial": "MISSING" }, { "matrix_id": "MX-121", "deployment_order": 140, "deployment_stage": "benchmark_learning", "section_id": "S11", "card_id": "rl-engine", "display_name": "RL Engine", "subcategory": "reward_model", "objective": "enable reinforcement learning component", "hard_dependencies": [ "MX-120" ], "blockers": [ "missing_rl_runtime" ], "evidence_expected": [ "rl_module", "reward_model" ], "checks": [ "module_presence_check" ], "pipeline_ref": "benchmark_learning", "contract_ref": "03_card_contract_minimums.yaml", "status_initial": "MISSING" }, { "matrix_id": "MX-122", "deployment_order": 140, "deployment_stage": "benchmark_learning", "section_id": "S11", "card_id": "learning-loop", "display_name": "Learning Loop", "subcategory": "promotion_decision", "objective": "compare outcomes, update memory and control promotion", "hard_dependencies": [ "MX-121", "MX-040", "MX-107" ], "blockers": [ "missing_learning_loop_runtime" ], "evidence_expected": [ "learning_loop_module", "promotion_decision_log" ], "checks": [ "runtime_presence_check", "decision_record_check" ], "pipeline_ref": "benchmark_learning", "contract_ref": "03_card_contract_minimums.yaml", "status_initial": "MISSING" }, { "matrix_id": "MX-130", "deployment_order": 150, "deployment_stage": "operator_panel", "section_id": "S12", "card_id": "operator-panel", "display_name": "Operator Panel", "subcategory": "contract_explorer", "objective": "expose canon, contracts and evidence in UI", "hard_dependencies": [ "MX-012", "MX-060", "MX-100" ], "blockers": [ "missing_panel_runtime", "missing_panel_schema" ], "evidence_expected": [ "panel_runtime", "contract_views", "evidence_drawers" ], "checks": [ "ui_load_check", "contract_view_check", "drawer_render_check" ], "pipeline_ref": "operator_panel", "contract_ref": "03_card_contract_minimums.yaml", "status_initial": "MISSING" }, { "matrix_id": "MX-140", "deployment_order": 160, "deployment_stage": "promotion_rollback", "section_id": "S12", "card_id": "operator-panel", "display_name": "Promotion & Rollback", "subcategory": "promotion_gate", "objective": "enforce final release gate with rollback readiness", "hard_dependencies": [ "MX-130", "MX-080", "MX-122" ], "blockers": [ "missing_rollback_strategy", "missing_release_audit" ], "evidence_expected": [ "release_gate_policy", "rollback_strategy", "release_audit" ], "checks": [ "promotion_gate_check", "rollback_readiness_check" ], "pipeline_ref": "operator_panel", "contract_ref": "03_card_contract_minimums.yaml", "status_initial": "MISSING" } ] }, "transition_status": "ACTIVE_DH_MIRROR", "hardening_status": "BUCKET_SCHEMA_PARTIAL", "engine_grade_final": false, "validation_mode": "schema_backed_transition", "parser_readiness": "medium", "hardening_priority": "schema_key_binding", "structural_contract": { "hardening_status": "HARDENING_PARTIAL", "engine_grade_final": false, "transition_status": "ACTIVE_DH_MIRROR", "doc_id": "canonical_matrix_v1", "category_id": "architecture_engineering_core", "phase_id": "phase-02", "hardening_lane": "json_schema_key_binding", "patch_type": "bind_schema_key_paths", "created_at": "2026-04-28T15:40:28.177121+00:00", "authority": { "authority_owner": "canonical_matrix_v1.json", "canonical_role": "canonical matrix audit authority", "authority_scope": "defines the matrix audit grid used to inspect coverage, deployment order, row identity, blockers, evidence, checks and repair routing without becoming tree, runtime or UI authority", "canonical_matrix_domain": [ "row identity", "deployment pressure", "coverage audit", "blocker/evidence checks", "repair routing" ], "not_authority_for": [ "canonical tree structure", "runtime status truth", "component lifecycle", "BI metric truth", "UI presentation behavior" ] }, "required_before": [ "coverage checks", "future scorecards", "docs relation view", "execution readiness map" ], "hard_dependencies": [ "panel_canonical_tree.json", "subcategory_pipelines.json", "card_contract_minimums.json" ], "feeds_operational_ui": [ "coverage_checks", "future_scorecards", "docs_relation_view", "execution_readiness_map" ], "bucket_contracts": { "Prerequisites": { "contract_role": "prove canonical_matrix_v1.json is materially present, phase-bound and dependency-bound before downstream consumers use it", "required_structural_fields": [ "authority_owner", "canonical_role", "required_before", "hard_dependencies", "canonical_matrix_domain" ], "validation_mode": "schema_backed_transition", "parser_readiness": "medium" }, "Installation": { "contract_role": "make canonical_matrix_v1 available as a Documentation Hub mirror with fixed technical identity and branch binding", "required_structural_fields": [ "doc_id", "category_id", "phase_id", "documentation_branch_status", "source_path", "expected_bindings" ], "validation_mode": "schema_backed_transition", "parser_readiness": "medium" }, "Configuration": { "contract_role": "bind canonical_matrix_v1 authority scope, dependency boundaries and forbidden ownership classes into parseable structure", "required_structural_fields": [ "authority_scope", "not_authority_for", "canonical_matrix_domain", "boundary_rules" ], "validation_mode": "schema_backed_transition", "parser_readiness": "medium" }, "Validation": { "contract_role": "convert canonical_matrix_v1 into deterministic PASS, FAIL and MISSING checks for identity, binding, source and authority boundary", "required_structural_fields": [ "validation_checks", "pass_criteria", "fail_criteria", "missing_criteria" ], "validation_mode": "schema_backed_transition", "parser_readiness": "medium" }, "Observable Evidence": { "contract_role": "expose file paths, DH branch binding, source payload shape and mirror path proving canonical_matrix_v1 is observable", "required_structural_fields": [ "evidence_paths", "expected_bindings", "observable_checks" ], "validation_mode": "schema_backed_transition", "parser_readiness": "medium" }, "Failure Modes & Recovery": { "contract_role": "recover missing source, wrong binding, dependency break, authority overreach and false promotion for canonical_matrix_v1", "required_structural_fields": [ "failure_modes", "recovery_actions", "rollback_or_safe_state" ], "validation_mode": "schema_backed_transition", "parser_readiness": "medium" }, "Completion & Promotion": { "contract_role": "promote canonical_matrix_v1 only as hardened DH mirror input, not as final engine-grade contract", "required_structural_fields": [ "done_when", "not_done_when", "promotion_gate", "canonization_gate" ], "validation_mode": "schema_backed_transition", "parser_readiness": "medium" } }, "validation_checks": [ { "check_id": "canonical_matrix_v1_doc_identity", "type": "exact_value", "path": "$.doc_id", "expected": "canonical_matrix_v1", "on_fail": "FAIL" }, { "check_id": "canonical_matrix_v1_category_binding", "type": "exact_value", "path": "$.category_id", "expected": "architecture_engineering_core", "on_fail": "FAIL" }, { "check_id": "canonical_matrix_v1_phase_binding", "type": "exact_value", "path": "$.phase_id", "expected": "phase-02", "on_fail": "FAIL" }, { "check_id": "canonical_matrix_v1_branch_status", "type": "exact_value", "path": "$.documentation_branch_status", "expected": "CUSTOM_BRANCH", "on_fail": "FAIL" }, { "check_id": "canonical_matrix_v1_authority_owner_declared", "type": "exact_value", "path": "$.structural_contract.authority.authority_owner", "expected": "canonical_matrix_v1.json", "on_fail": "FAIL" }, { "check_id": "canonical_matrix_v1_not_engine_final", "type": "exact_value", "path": "$.engine_grade_final", "expected": false, "on_fail": "FAIL" }, { "check_id": "canonical_matrix_v1_source_payload_object_present", "type": "object_present", "path": "$.source_payload", "on_missing": "MISSING", "on_fail": "FAIL" }, { "check_id": "canonical_matrix_v1_depends_on_panel_canonical_tree_json", "type": "array_contains", "path": "$.structural_contract.hard_dependencies", "expected": "panel_canonical_tree.json", "on_fail": "FAIL" }, { "check_id": "canonical_matrix_v1_depends_on_subcategory_pipelines_json", "type": "array_contains", "path": "$.structural_contract.hard_dependencies", "expected": "subcategory_pipelines.json", "on_fail": "FAIL" }, { "check_id": "canonical_matrix_v1_depends_on_card_contract_minimums_json", "type": "array_contains", "path": "$.structural_contract.hard_dependencies", "expected": "card_contract_minimums.json", "on_fail": "FAIL" } ], "evidence_paths": [ "/home/yeff/public_html/devon/panel/data/canonical_matrix_v1.json", "/home/yeff/public_html/devon/docs/index.php", "/home/yeff/public_html/devon/panel/data/hub_index.json", "/home/yeff/public_html/devon/panel/data/master_architecture_index.md", "/home/yeff/public_html/devon/docs/json/phase-02/canonical_matrix_v1.json", "/home/yeff/public_html/devon/docs/json/phase-02/_phase02_hardening_queue.json" ], "expected_bindings": [ { "binding": "docs_index_custom_branch", "expected": "if (doc.id === \"canonical_matrix_v1\" && state.categoryId === \"architecture_engineering_core\")" }, { "binding": "hub_index_phase", "expected_phase_id": "phase-02" }, { "binding": "hub_index_category", "expected_category_id": "architecture_engineering_core" } ], "failure_modes": [ { "failure_id": "canonical_matrix_v1_source_missing", "status": "MISSING", "meaning": "canonical_matrix_v1 source cannot be read from declared source path", "recovery_action": "restore /home/yeff/public_html/devon/panel/data/canonical_matrix_v1.json or the declared mirror source before hardening can continue" }, { "failure_id": "canonical_matrix_v1_unbound_from_phase02", "status": "FAIL", "meaning": "canonical_matrix_v1 is present but not bound to phase-02 / architecture_engineering_core", "recovery_action": "restore hub_index and docs/index binding to the canonical Phase 02 category" }, { "failure_id": "canonical_matrix_v1_dependency_missing", "status": "MISSING", "meaning": "canonical_matrix_v1 cannot prove declared hard dependencies", "recovery_action": "restore declared dependencies or block promotion until dependency validation passes" }, { "failure_id": "canonical_matrix_v1_authority_overreach", "status": "FAIL", "meaning": "canonical_matrix_v1 claims authority outside its declared scope", "recovery_action": "revoke overreaching authority and route the claim to the owning document or contract" }, { "failure_id": "canonical_matrix_v1_false_engine_promotion", "status": "FAIL", "meaning": "canonical_matrix_v1 is promoted as engine-grade final while still in DH mirror transition", "recovery_action": "restore ACTIVE_DH_MIRROR / HARDENING_PARTIAL and require deterministic schema validation before final promotion" } ], "promotion_gates": { "done_when": [ "canonical_matrix_v1 source exists materially", "canonical_matrix_v1 is registered under Phase 02", "canonical_matrix_v1 has a custom Documentation Hub branch", "canonical_matrix_v1 JSON mirror contains structural_contract", "canonical_matrix_v1 exposes authority, dependencies, evidence paths, validation checks and promotion gates as parseable fields" ], "not_done_when": [ "source payload is missing", "category binding is wrong", "declared dependency is absent", "authority scope is overreached", "engine_grade_final is set true before deterministic schema validation exists" ], "promotion_gate": "canonical_matrix_v1 may move to HARDENING_PARTIAL after structural_contract exists and verifies, but must not become engine_grade_final until all decisive checks are schema-backed and deterministic.", "canonization_gate": "canonical_matrix_v1 remains an ACTIVE_DH_MIRROR until authority, dependency, evidence, failure and promotion checks can be consumed without semantic prose interpretation." }, "parser_readiness_after_patch": "medium", "blocked_until_engine_grade_final": [ "all validation checks resolve from JSON key paths", "all required dependencies are machine-checkable", "all authority boundaries produce deterministic FAIL when violated", "future operational panel can consume the contract without reading source prose" ], "mirror_type": "json_mirror", "schema_binding": { "required_keys": [ "source_payload" ], "source_payload_key_paths": [ "$.source_payload", "$.structural_contract", "$.bucket_statuses_from_docs_index" ], "expected_values": { "$.phase_id": "phase-02", "$.category_id": "architecture_engineering_core", "$.doc_id": "canonical_matrix_v1", "$.engine_grade_final": false, "$.transition_status": "ACTIVE_DH_MIRROR" }, "allowed_statuses": [ "PASS", "FAIL", "MISSING", "ACTIVE_DH_MIRROR", "HARDENING_PARTIAL" ], "deterministic_fail_modes": [ "wrong_doc_id", "wrong_category_id", "wrong_phase_id", "missing_source_payload", "authority_overreach", "false_engine_promotion" ], "missing_criteria": [ "source payload absent", "declared source file absent", "hard dependency absent where required" ], "schema_backed_validation": true }, "boundary_rules": [ { "rule_id": "matrix_audits_not_owns", "meaning": "matrix checks authorities without replacing them", "fail_state": "FAIL when matrix becomes source-of-truth" }, { "rule_id": "row_identity_required", "meaning": "coverage row must have stable matrix identity", "fail_state": "FAIL when row cannot be addressed" }, { "rule_id": "deployment_order_preserved", "meaning": "matrix readiness must preserve deployment pressure", "fail_state": "FAIL when matrix becomes flat inventory" } ], "required_keys": [ "source_payload" ], "schema_boundary_rules": [ { "rule_id": "matrix_audits_not_owns", "meaning": "matrix checks authorities without replacing them", "fail_state": "FAIL when matrix becomes source-of-truth" }, { "rule_id": "row_identity_required", "meaning": "coverage row must have stable matrix identity", "fail_state": "FAIL when row cannot be addressed" }, { "rule_id": "deployment_order_preserved", "meaning": "matrix readiness must preserve deployment pressure", "fail_state": "FAIL when matrix becomes flat inventory" } ], "source_signal_audit": { "source_payload_is_object": true, "source_payload_top_keys": [ "canon_meta", "matrix" ], "audit_note": "source_signal_audit records JSON mirror shape only; structural_contract remains governed by schema key binding and Phase 02 queue" }, "bucket_schema_checks": { "prerequisites": { "bucket_name": "Prerequisites", "bucket_key": "prerequisites", "schema_status": "BUCKET_SCHEMA_PARTIAL", "engine_grade_final": false, "validation_mode": "schema_backed_transition", "parser_readiness": "medium", "next_patch_type": "expand_bucket_level_schema_checks", "required_schema_checks": [ "doc_identity", "phase_binding", "category_binding", "authority_owner_present", "hard_dependencies_present", "required_before_present" ], "target_key_paths": [ "$.doc_id", "$.phase_id", "$.category_id", "$.structural_contract.authority.authority_owner", "$.structural_contract.hard_dependencies", "$.structural_contract.required_before" ], "schema_checks": [ { "check_id": "canonical_matrix_v1_prerequisites_doc_identity", "bucket_name": "Prerequisites", "bucket_key": "prerequisites", "check_order": 1, "check_name": "doc_identity", "type": "key_path_declared", "target_key_path": "$.doc_id", "expected_result": "observable_or_declared", "pass_when": "target key path exists or declared evidence path is present in the category JSON structural contract", "fail_when": "target key path is contradicted, malformed, or points outside the declared Phase 02 category contract", "missing_when": "target key path is absent and no declared evidence path can support the bucket requirement", "allowed_statuses": [ "PASS", "FAIL", "MISSING" ], "engine_grade_final_required": false }, { "check_id": "canonical_matrix_v1_prerequisites_phase_binding", "bucket_name": "Prerequisites", "bucket_key": "prerequisites", "check_order": 2, "check_name": "phase_binding", "type": "key_path_declared", "target_key_path": "$.phase_id", "expected_result": "observable_or_declared", "pass_when": "target key path exists or declared evidence path is present in the category JSON structural contract", "fail_when": "target key path is contradicted, malformed, or points outside the declared Phase 02 category contract", "missing_when": "target key path is absent and no declared evidence path can support the bucket requirement", "allowed_statuses": [ "PASS", "FAIL", "MISSING" ], "engine_grade_final_required": false }, { "check_id": "canonical_matrix_v1_prerequisites_category_binding", "bucket_name": "Prerequisites", "bucket_key": "prerequisites", "check_order": 3, "check_name": "category_binding", "type": "key_path_declared", "target_key_path": "$.category_id", "expected_result": "observable_or_declared", "pass_when": "target key path exists or declared evidence path is present in the category JSON structural contract", "fail_when": "target key path is contradicted, malformed, or points outside the declared Phase 02 category contract", "missing_when": "target key path is absent and no declared evidence path can support the bucket requirement", "allowed_statuses": [ "PASS", "FAIL", "MISSING" ], "engine_grade_final_required": false }, { "check_id": "canonical_matrix_v1_prerequisites_authority_owner_present", "bucket_name": "Prerequisites", "bucket_key": "prerequisites", "check_order": 4, "check_name": "authority_owner_present", "type": "key_path_declared", "target_key_path": "$.structural_contract.authority.authority_owner", "expected_result": "observable_or_declared", "pass_when": "target key path exists or declared evidence path is present in the category JSON structural contract", "fail_when": "target key path is contradicted, malformed, or points outside the declared Phase 02 category contract", "missing_when": "target key path is absent and no declared evidence path can support the bucket requirement", "allowed_statuses": [ "PASS", "FAIL", "MISSING" ], "engine_grade_final_required": false }, { "check_id": "canonical_matrix_v1_prerequisites_hard_dependencies_present", "bucket_name": "Prerequisites", "bucket_key": "prerequisites", "check_order": 5, "check_name": "hard_dependencies_present", "type": "key_path_declared", "target_key_path": "$.structural_contract.hard_dependencies", "expected_result": "observable_or_declared", "pass_when": "target key path exists or declared evidence path is present in the category JSON structural contract", "fail_when": "target key path is contradicted, malformed, or points outside the declared Phase 02 category contract", "missing_when": "target key path is absent and no declared evidence path can support the bucket requirement", "allowed_statuses": [ "PASS", "FAIL", "MISSING" ], "engine_grade_final_required": false }, { "check_id": "canonical_matrix_v1_prerequisites_required_before_present", "bucket_name": "Prerequisites", "bucket_key": "prerequisites", "check_order": 6, "check_name": "required_before_present", "type": "key_path_declared", "target_key_path": "$.structural_contract.required_before", "expected_result": "observable_or_declared", "pass_when": "target key path exists or declared evidence path is present in the category JSON structural contract", "fail_when": "target key path is contradicted, malformed, or points outside the declared Phase 02 category contract", "missing_when": "target key path is absent and no declared evidence path can support the bucket requirement", "allowed_statuses": [ "PASS", "FAIL", "MISSING" ], "engine_grade_final_required": false } ], "deterministic_outcomes": { "PASS": "all required bucket key paths resolve or are explicitly declared as evidence-backed transitional paths", "FAIL": "one or more required bucket key paths contradict the declared category contract", "MISSING": "one or more required bucket key paths are absent and have no evidence-backed declaration" }, "blocked_until": [ "bucket has explicit key-bound checks", "bucket has deterministic PASS/FAIL/MISSING outcomes", "bucket can be consumed by future operational panel without prose interpretation" ], "promotion_rule": "bucket cannot promote to BUCKET_SCHEMA_READY until each check resolves from deterministic JSON key paths without prose interpretation", "future_panel_consumption": { "consumer": "future operational panel", "mode": "read bucket_schema_checks before treating bucket as executable contract input", "prohibited": "do not treat DH mirror prose as final engine-grade proof" } }, "installation": { "bucket_name": "Installation", "bucket_key": "installation", "schema_status": "BUCKET_SCHEMA_PARTIAL", "engine_grade_final": false, "validation_mode": "schema_backed_transition", "parser_readiness": "medium", "next_patch_type": "expand_bucket_level_schema_checks", "required_schema_checks": [ "custom_branch_binding", "source_path_present", "documentation_status", "dh_mirror_status" ], "target_key_paths": [ "$.documentation_branch_status", "$.source_path", "$.transition_status", "$.hardening_status" ], "schema_checks": [ { "check_id": "canonical_matrix_v1_installation_custom_branch_binding", "bucket_name": "Installation", "bucket_key": "installation", "check_order": 1, "check_name": "custom_branch_binding", "type": "key_path_declared", "target_key_path": "$.documentation_branch_status", "expected_result": "observable_or_declared", "pass_when": "target key path exists or declared evidence path is present in the category JSON structural contract", "fail_when": "target key path is contradicted, malformed, or points outside the declared Phase 02 category contract", "missing_when": "target key path is absent and no declared evidence path can support the bucket requirement", "allowed_statuses": [ "PASS", "FAIL", "MISSING" ], "engine_grade_final_required": false }, { "check_id": "canonical_matrix_v1_installation_source_path_present", "bucket_name": "Installation", "bucket_key": "installation", "check_order": 2, "check_name": "source_path_present", "type": "key_path_declared", "target_key_path": "$.source_path", "expected_result": "observable_or_declared", "pass_when": "target key path exists or declared evidence path is present in the category JSON structural contract", "fail_when": "target key path is contradicted, malformed, or points outside the declared Phase 02 category contract", "missing_when": "target key path is absent and no declared evidence path can support the bucket requirement", "allowed_statuses": [ "PASS", "FAIL", "MISSING" ], "engine_grade_final_required": false }, { "check_id": "canonical_matrix_v1_installation_documentation_status", "bucket_name": "Installation", "bucket_key": "installation", "check_order": 3, "check_name": "documentation_status", "type": "key_path_declared", "target_key_path": "$.transition_status", "expected_result": "observable_or_declared", "pass_when": "target key path exists or declared evidence path is present in the category JSON structural contract", "fail_when": "target key path is contradicted, malformed, or points outside the declared Phase 02 category contract", "missing_when": "target key path is absent and no declared evidence path can support the bucket requirement", "allowed_statuses": [ "PASS", "FAIL", "MISSING" ], "engine_grade_final_required": false }, { "check_id": "canonical_matrix_v1_installation_dh_mirror_status", "bucket_name": "Installation", "bucket_key": "installation", "check_order": 4, "check_name": "dh_mirror_status", "type": "key_path_declared", "target_key_path": "$.hardening_status", "expected_result": "observable_or_declared", "pass_when": "target key path exists or declared evidence path is present in the category JSON structural contract", "fail_when": "target key path is contradicted, malformed, or points outside the declared Phase 02 category contract", "missing_when": "target key path is absent and no declared evidence path can support the bucket requirement", "allowed_statuses": [ "PASS", "FAIL", "MISSING" ], "engine_grade_final_required": false } ], "deterministic_outcomes": { "PASS": "all required bucket key paths resolve or are explicitly declared as evidence-backed transitional paths", "FAIL": "one or more required bucket key paths contradict the declared category contract", "MISSING": "one or more required bucket key paths are absent and have no evidence-backed declaration" }, "blocked_until": [ "bucket has explicit key-bound checks", "bucket has deterministic PASS/FAIL/MISSING outcomes", "bucket can be consumed by future operational panel without prose interpretation" ], "promotion_rule": "bucket cannot promote to BUCKET_SCHEMA_READY until each check resolves from deterministic JSON key paths without prose interpretation", "future_panel_consumption": { "consumer": "future operational panel", "mode": "read bucket_schema_checks before treating bucket as executable contract input", "prohibited": "do not treat DH mirror prose as final engine-grade proof" } }, "configuration": { "bucket_name": "Configuration", "bucket_key": "configuration", "schema_status": "BUCKET_SCHEMA_PARTIAL", "engine_grade_final": false, "validation_mode": "schema_backed_transition", "parser_readiness": "medium", "next_patch_type": "expand_bucket_level_schema_checks", "required_schema_checks": [ "authority_scope_present", "domain_present", "forbidden_authority_boundary", "feeds_operational_ui_present" ], "target_key_paths": [ "$.structural_contract.authority.authority_scope", "$.structural_contract.authority", "$.structural_contract.authority.not_authority_for", "$.structural_contract.feeds_operational_ui" ], "schema_checks": [ { "check_id": "canonical_matrix_v1_configuration_authority_scope_present", "bucket_name": "Configuration", "bucket_key": "configuration", "check_order": 1, "check_name": "authority_scope_present", "type": "key_path_declared", "target_key_path": "$.structural_contract.authority.authority_scope", "expected_result": "observable_or_declared", "pass_when": "target key path exists or declared evidence path is present in the category JSON structural contract", "fail_when": "target key path is contradicted, malformed, or points outside the declared Phase 02 category contract", "missing_when": "target key path is absent and no declared evidence path can support the bucket requirement", "allowed_statuses": [ "PASS", "FAIL", "MISSING" ], "engine_grade_final_required": false }, { "check_id": "canonical_matrix_v1_configuration_domain_present", "bucket_name": "Configuration", "bucket_key": "configuration", "check_order": 2, "check_name": "domain_present", "type": "key_path_declared", "target_key_path": "$.structural_contract.authority", "expected_result": "observable_or_declared", "pass_when": "target key path exists or declared evidence path is present in the category JSON structural contract", "fail_when": "target key path is contradicted, malformed, or points outside the declared Phase 02 category contract", "missing_when": "target key path is absent and no declared evidence path can support the bucket requirement", "allowed_statuses": [ "PASS", "FAIL", "MISSING" ], "engine_grade_final_required": false }, { "check_id": "canonical_matrix_v1_configuration_forbidden_authority_boundary", "bucket_name": "Configuration", "bucket_key": "configuration", "check_order": 3, "check_name": "forbidden_authority_boundary", "type": "key_path_declared", "target_key_path": "$.structural_contract.authority.not_authority_for", "expected_result": "observable_or_declared", "pass_when": "target key path exists or declared evidence path is present in the category JSON structural contract", "fail_when": "target key path is contradicted, malformed, or points outside the declared Phase 02 category contract", "missing_when": "target key path is absent and no declared evidence path can support the bucket requirement", "allowed_statuses": [ "PASS", "FAIL", "MISSING" ], "engine_grade_final_required": false }, { "check_id": "canonical_matrix_v1_configuration_feeds_operational_ui_present", "bucket_name": "Configuration", "bucket_key": "configuration", "check_order": 4, "check_name": "feeds_operational_ui_present", "type": "key_path_declared", "target_key_path": "$.structural_contract.feeds_operational_ui", "expected_result": "observable_or_declared", "pass_when": "target key path exists or declared evidence path is present in the category JSON structural contract", "fail_when": "target key path is contradicted, malformed, or points outside the declared Phase 02 category contract", "missing_when": "target key path is absent and no declared evidence path can support the bucket requirement", "allowed_statuses": [ "PASS", "FAIL", "MISSING" ], "engine_grade_final_required": false } ], "deterministic_outcomes": { "PASS": "all required bucket key paths resolve or are explicitly declared as evidence-backed transitional paths", "FAIL": "one or more required bucket key paths contradict the declared category contract", "MISSING": "one or more required bucket key paths are absent and have no evidence-backed declaration" }, "blocked_until": [ "bucket has explicit key-bound checks", "bucket has deterministic PASS/FAIL/MISSING outcomes", "bucket can be consumed by future operational panel without prose interpretation" ], "promotion_rule": "bucket cannot promote to BUCKET_SCHEMA_READY until each check resolves from deterministic JSON key paths without prose interpretation", "future_panel_consumption": { "consumer": "future operational panel", "mode": "read bucket_schema_checks before treating bucket as executable contract input", "prohibited": "do not treat DH mirror prose as final engine-grade proof" } }, "validation": { "bucket_name": "Validation", "bucket_key": "validation", "schema_status": "BUCKET_SCHEMA_PARTIAL", "engine_grade_final": false, "validation_mode": "schema_backed_transition", "parser_readiness": "medium", "next_patch_type": "expand_bucket_level_schema_checks", "required_schema_checks": [ "validation_checks_present", "validation_checks_are_key_bound", "fail_missing_outcomes_declared", "engine_final_blocked" ], "target_key_paths": [ "$.structural_contract.validation_checks", "$.structural_contract.schema_binding", "$.structural_contract.schema_binding.deterministic_fail_modes", "$.engine_grade_final" ], "schema_checks": [ { "check_id": "canonical_matrix_v1_validation_validation_checks_present", "bucket_name": "Validation", "bucket_key": "validation", "check_order": 1, "check_name": "validation_checks_present", "type": "key_path_declared", "target_key_path": "$.structural_contract.validation_checks", "expected_result": "observable_or_declared", "pass_when": "target key path exists or declared evidence path is present in the category JSON structural contract", "fail_when": "target key path is contradicted, malformed, or points outside the declared Phase 02 category contract", "missing_when": "target key path is absent and no declared evidence path can support the bucket requirement", "allowed_statuses": [ "PASS", "FAIL", "MISSING" ], "engine_grade_final_required": false }, { "check_id": "canonical_matrix_v1_validation_validation_checks_are_key_bound", "bucket_name": "Validation", "bucket_key": "validation", "check_order": 2, "check_name": "validation_checks_are_key_bound", "type": "key_path_declared", "target_key_path": "$.structural_contract.schema_binding", "expected_result": "observable_or_declared", "pass_when": "target key path exists or declared evidence path is present in the category JSON structural contract", "fail_when": "target key path is contradicted, malformed, or points outside the declared Phase 02 category contract", "missing_when": "target key path is absent and no declared evidence path can support the bucket requirement", "allowed_statuses": [ "PASS", "FAIL", "MISSING" ], "engine_grade_final_required": false }, { "check_id": "canonical_matrix_v1_validation_fail_missing_outcomes_declared", "bucket_name": "Validation", "bucket_key": "validation", "check_order": 3, "check_name": "fail_missing_outcomes_declared", "type": "key_path_declared", "target_key_path": "$.structural_contract.schema_binding.deterministic_fail_modes", "expected_result": "observable_or_declared", "pass_when": "target key path exists or declared evidence path is present in the category JSON structural contract", "fail_when": "target key path is contradicted, malformed, or points outside the declared Phase 02 category contract", "missing_when": "target key path is absent and no declared evidence path can support the bucket requirement", "allowed_statuses": [ "PASS", "FAIL", "MISSING" ], "engine_grade_final_required": false }, { "check_id": "canonical_matrix_v1_validation_engine_final_blocked", "bucket_name": "Validation", "bucket_key": "validation", "check_order": 4, "check_name": "engine_final_blocked", "type": "key_path_declared", "target_key_path": "$.engine_grade_final", "expected_result": "observable_or_declared", "pass_when": "target key path exists or declared evidence path is present in the category JSON structural contract", "fail_when": "target key path is contradicted, malformed, or points outside the declared Phase 02 category contract", "missing_when": "target key path is absent and no declared evidence path can support the bucket requirement", "allowed_statuses": [ "PASS", "FAIL", "MISSING" ], "engine_grade_final_required": false } ], "deterministic_outcomes": { "PASS": "all required bucket key paths resolve or are explicitly declared as evidence-backed transitional paths", "FAIL": "one or more required bucket key paths contradict the declared category contract", "MISSING": "one or more required bucket key paths are absent and have no evidence-backed declaration" }, "blocked_until": [ "bucket has explicit key-bound checks", "bucket has deterministic PASS/FAIL/MISSING outcomes", "bucket can be consumed by future operational panel without prose interpretation" ], "promotion_rule": "bucket cannot promote to BUCKET_SCHEMA_READY until each check resolves from deterministic JSON key paths without prose interpretation", "future_panel_consumption": { "consumer": "future operational panel", "mode": "read bucket_schema_checks before treating bucket as executable contract input", "prohibited": "do not treat DH mirror prose as final engine-grade proof" } }, "observable_evidence": { "bucket_name": "Observable Evidence", "bucket_key": "observable_evidence", "schema_status": "BUCKET_SCHEMA_PARTIAL", "engine_grade_final": false, "validation_mode": "schema_backed_transition", "parser_readiness": "medium", "next_patch_type": "expand_bucket_level_schema_checks", "required_schema_checks": [ "evidence_paths_present", "doc_json_path_present", "expected_bindings_present", "source_signal_audit_present" ], "target_key_paths": [ "$.structural_contract.evidence_paths", "/home/yeff/public_html/devon/docs/json/phase-02/canonical_matrix_v1.json", "$.structural_contract.expected_bindings", "$.structural_contract.source_signal_audit" ], "schema_checks": [ { "check_id": "canonical_matrix_v1_observable_evidence_evidence_paths_present", "bucket_name": "Observable Evidence", "bucket_key": "observable_evidence", "check_order": 1, "check_name": "evidence_paths_present", "type": "key_path_declared", "target_key_path": "$.structural_contract.evidence_paths", "expected_result": "observable_or_declared", "pass_when": "target key path exists or declared evidence path is present in the category JSON structural contract", "fail_when": "target key path is contradicted, malformed, or points outside the declared Phase 02 category contract", "missing_when": "target key path is absent and no declared evidence path can support the bucket requirement", "allowed_statuses": [ "PASS", "FAIL", "MISSING" ], "engine_grade_final_required": false }, { "check_id": "canonical_matrix_v1_observable_evidence_doc_json_path_present", "bucket_name": "Observable Evidence", "bucket_key": "observable_evidence", "check_order": 2, "check_name": "doc_json_path_present", "type": "key_path_declared", "target_key_path": "/home/yeff/public_html/devon/docs/json/phase-02/canonical_matrix_v1.json", "expected_result": "observable_or_declared", "pass_when": "target key path exists or declared evidence path is present in the category JSON structural contract", "fail_when": "target key path is contradicted, malformed, or points outside the declared Phase 02 category contract", "missing_when": "target key path is absent and no declared evidence path can support the bucket requirement", "allowed_statuses": [ "PASS", "FAIL", "MISSING" ], "engine_grade_final_required": false }, { "check_id": "canonical_matrix_v1_observable_evidence_expected_bindings_present", "bucket_name": "Observable Evidence", "bucket_key": "observable_evidence", "check_order": 3, "check_name": "expected_bindings_present", "type": "key_path_declared", "target_key_path": "$.structural_contract.expected_bindings", "expected_result": "observable_or_declared", "pass_when": "target key path exists or declared evidence path is present in the category JSON structural contract", "fail_when": "target key path is contradicted, malformed, or points outside the declared Phase 02 category contract", "missing_when": "target key path is absent and no declared evidence path can support the bucket requirement", "allowed_statuses": [ "PASS", "FAIL", "MISSING" ], "engine_grade_final_required": false }, { "check_id": "canonical_matrix_v1_observable_evidence_source_signal_audit_present", "bucket_name": "Observable Evidence", "bucket_key": "observable_evidence", "check_order": 4, "check_name": "source_signal_audit_present", "type": "key_path_declared", "target_key_path": "$.structural_contract.source_signal_audit", "expected_result": "observable_or_declared", "pass_when": "target key path exists or declared evidence path is present in the category JSON structural contract", "fail_when": "target key path is contradicted, malformed, or points outside the declared Phase 02 category contract", "missing_when": "target key path is absent and no declared evidence path can support the bucket requirement", "allowed_statuses": [ "PASS", "FAIL", "MISSING" ], "engine_grade_final_required": false } ], "deterministic_outcomes": { "PASS": "all required bucket key paths resolve or are explicitly declared as evidence-backed transitional paths", "FAIL": "one or more required bucket key paths contradict the declared category contract", "MISSING": "one or more required bucket key paths are absent and have no evidence-backed declaration" }, "blocked_until": [ "bucket has explicit key-bound checks", "bucket has deterministic PASS/FAIL/MISSING outcomes", "bucket can be consumed by future operational panel without prose interpretation" ], "promotion_rule": "bucket cannot promote to BUCKET_SCHEMA_READY until each check resolves from deterministic JSON key paths without prose interpretation", "future_panel_consumption": { "consumer": "future operational panel", "mode": "read bucket_schema_checks before treating bucket as executable contract input", "prohibited": "do not treat DH mirror prose as final engine-grade proof" } }, "failure_modes_recovery": { "bucket_name": "Failure Modes & Recovery", "bucket_key": "failure_modes_recovery", "schema_status": "BUCKET_SCHEMA_PARTIAL", "engine_grade_final": false, "validation_mode": "schema_backed_transition", "parser_readiness": "medium", "next_patch_type": "expand_bucket_level_schema_checks", "required_schema_checks": [ "failure_modes_present", "recovery_actions_declared", "rollback_or_safe_state_present", "false_engine_promotion_blocked" ], "target_key_paths": [ "$.structural_contract.failure_modes", "$.structural_contract.failure_modes[*].recovery_action", "$.structural_contract.promotion_gates.not_done_when", "$.structural_contract.schema_binding.deterministic_fail_modes" ], "schema_checks": [ { "check_id": "canonical_matrix_v1_failure_modes_recovery_failure_modes_present", "bucket_name": "Failure Modes & Recovery", "bucket_key": "failure_modes_recovery", "check_order": 1, "check_name": "failure_modes_present", "type": "key_path_declared", "target_key_path": "$.structural_contract.failure_modes", "expected_result": "observable_or_declared", "pass_when": "target key path exists or declared evidence path is present in the category JSON structural contract", "fail_when": "target key path is contradicted, malformed, or points outside the declared Phase 02 category contract", "missing_when": "target key path is absent and no declared evidence path can support the bucket requirement", "allowed_statuses": [ "PASS", "FAIL", "MISSING" ], "engine_grade_final_required": false }, { "check_id": "canonical_matrix_v1_failure_modes_recovery_recovery_actions_declared", "bucket_name": "Failure Modes & Recovery", "bucket_key": "failure_modes_recovery", "check_order": 2, "check_name": "recovery_actions_declared", "type": "key_path_declared", "target_key_path": "$.structural_contract.failure_modes[*].recovery_action", "expected_result": "observable_or_declared", "pass_when": "target key path exists or declared evidence path is present in the category JSON structural contract", "fail_when": "target key path is contradicted, malformed, or points outside the declared Phase 02 category contract", "missing_when": "target key path is absent and no declared evidence path can support the bucket requirement", "allowed_statuses": [ "PASS", "FAIL", "MISSING" ], "engine_grade_final_required": false }, { "check_id": "canonical_matrix_v1_failure_modes_recovery_rollback_or_safe_state_present", "bucket_name": "Failure Modes & Recovery", "bucket_key": "failure_modes_recovery", "check_order": 3, "check_name": "rollback_or_safe_state_present", "type": "key_path_declared", "target_key_path": "$.structural_contract.promotion_gates.not_done_when", "expected_result": "observable_or_declared", "pass_when": "target key path exists or declared evidence path is present in the category JSON structural contract", "fail_when": "target key path is contradicted, malformed, or points outside the declared Phase 02 category contract", "missing_when": "target key path is absent and no declared evidence path can support the bucket requirement", "allowed_statuses": [ "PASS", "FAIL", "MISSING" ], "engine_grade_final_required": false }, { "check_id": "canonical_matrix_v1_failure_modes_recovery_false_engine_promotion_blocked", "bucket_name": "Failure Modes & Recovery", "bucket_key": "failure_modes_recovery", "check_order": 4, "check_name": "false_engine_promotion_blocked", "type": "key_path_declared", "target_key_path": "$.structural_contract.schema_binding.deterministic_fail_modes", "expected_result": "observable_or_declared", "pass_when": "target key path exists or declared evidence path is present in the category JSON structural contract", "fail_when": "target key path is contradicted, malformed, or points outside the declared Phase 02 category contract", "missing_when": "target key path is absent and no declared evidence path can support the bucket requirement", "allowed_statuses": [ "PASS", "FAIL", "MISSING" ], "engine_grade_final_required": false } ], "deterministic_outcomes": { "PASS": "all required bucket key paths resolve or are explicitly declared as evidence-backed transitional paths", "FAIL": "one or more required bucket key paths contradict the declared category contract", "MISSING": "one or more required bucket key paths are absent and have no evidence-backed declaration" }, "blocked_until": [ "bucket has explicit key-bound checks", "bucket has deterministic PASS/FAIL/MISSING outcomes", "bucket can be consumed by future operational panel without prose interpretation" ], "promotion_rule": "bucket cannot promote to BUCKET_SCHEMA_READY until each check resolves from deterministic JSON key paths without prose interpretation", "future_panel_consumption": { "consumer": "future operational panel", "mode": "read bucket_schema_checks before treating bucket as executable contract input", "prohibited": "do not treat DH mirror prose as final engine-grade proof" } }, "completion_promotion": { "bucket_name": "Completion & Promotion", "bucket_key": "completion_promotion", "schema_status": "BUCKET_SCHEMA_PARTIAL", "engine_grade_final": false, "validation_mode": "schema_backed_transition", "parser_readiness": "medium", "next_patch_type": "expand_bucket_level_schema_checks", "required_schema_checks": [ "done_when_present", "not_done_when_present", "promotion_gate_present", "canonization_gate_present", "engine_final_requires_schema" ], "target_key_paths": [ "$.structural_contract.promotion_gates.done_when", "$.structural_contract.promotion_gates.not_done_when", "$.structural_contract.promotion_gates.promotion_gate", "$.structural_contract.promotion_gates.canonization_gate", "$.engine_grade_final" ], "schema_checks": [ { "check_id": "canonical_matrix_v1_completion_promotion_done_when_present", "bucket_name": "Completion & Promotion", "bucket_key": "completion_promotion", "check_order": 1, "check_name": "done_when_present", "type": "key_path_declared", "target_key_path": "$.structural_contract.promotion_gates.done_when", "expected_result": "observable_or_declared", "pass_when": "target key path exists or declared evidence path is present in the category JSON structural contract", "fail_when": "target key path is contradicted, malformed, or points outside the declared Phase 02 category contract", "missing_when": "target key path is absent and no declared evidence path can support the bucket requirement", "allowed_statuses": [ "PASS", "FAIL", "MISSING" ], "engine_grade_final_required": false }, { "check_id": "canonical_matrix_v1_completion_promotion_not_done_when_present", "bucket_name": "Completion & Promotion", "bucket_key": "completion_promotion", "check_order": 2, "check_name": "not_done_when_present", "type": "key_path_declared", "target_key_path": "$.structural_contract.promotion_gates.not_done_when", "expected_result": "observable_or_declared", "pass_when": "target key path exists or declared evidence path is present in the category JSON structural contract", "fail_when": "target key path is contradicted, malformed, or points outside the declared Phase 02 category contract", "missing_when": "target key path is absent and no declared evidence path can support the bucket requirement", "allowed_statuses": [ "PASS", "FAIL", "MISSING" ], "engine_grade_final_required": false }, { "check_id": "canonical_matrix_v1_completion_promotion_promotion_gate_present", "bucket_name": "Completion & Promotion", "bucket_key": "completion_promotion", "check_order": 3, "check_name": "promotion_gate_present", "type": "key_path_declared", "target_key_path": "$.structural_contract.promotion_gates.promotion_gate", "expected_result": "observable_or_declared", "pass_when": "target key path exists or declared evidence path is present in the category JSON structural contract", "fail_when": "target key path is contradicted, malformed, or points outside the declared Phase 02 category contract", "missing_when": "target key path is absent and no declared evidence path can support the bucket requirement", "allowed_statuses": [ "PASS", "FAIL", "MISSING" ], "engine_grade_final_required": false }, { "check_id": "canonical_matrix_v1_completion_promotion_canonization_gate_present", "bucket_name": "Completion & Promotion", "bucket_key": "completion_promotion", "check_order": 4, "check_name": "canonization_gate_present", "type": "key_path_declared", "target_key_path": "$.structural_contract.promotion_gates.canonization_gate", "expected_result": "observable_or_declared", "pass_when": "target key path exists or declared evidence path is present in the category JSON structural contract", "fail_when": "target key path is contradicted, malformed, or points outside the declared Phase 02 category contract", "missing_when": "target key path is absent and no declared evidence path can support the bucket requirement", "allowed_statuses": [ "PASS", "FAIL", "MISSING" ], "engine_grade_final_required": false }, { "check_id": "canonical_matrix_v1_completion_promotion_engine_final_requires_schema", "bucket_name": "Completion & Promotion", "bucket_key": "completion_promotion", "check_order": 5, "check_name": "engine_final_requires_schema", "type": "key_path_declared", "target_key_path": "$.engine_grade_final", "expected_result": "observable_or_declared", "pass_when": "target key path exists or declared evidence path is present in the category JSON structural contract", "fail_when": "target key path is contradicted, malformed, or points outside the declared Phase 02 category contract", "missing_when": "target key path is absent and no declared evidence path can support the bucket requirement", "allowed_statuses": [ "PASS", "FAIL", "MISSING" ], "engine_grade_final_required": false } ], "deterministic_outcomes": { "PASS": "all required bucket key paths resolve or are explicitly declared as evidence-backed transitional paths", "FAIL": "one or more required bucket key paths contradict the declared category contract", "MISSING": "one or more required bucket key paths are absent and have no evidence-backed declaration" }, "blocked_until": [ "bucket has explicit key-bound checks", "bucket has deterministic PASS/FAIL/MISSING outcomes", "bucket can be consumed by future operational panel without prose interpretation" ], "promotion_rule": "bucket cannot promote to BUCKET_SCHEMA_READY until each check resolves from deterministic JSON key paths without prose interpretation", "future_panel_consumption": { "consumer": "future operational panel", "mode": "read bucket_schema_checks before treating bucket as executable contract input", "prohibited": "do not treat DH mirror prose as final engine-grade proof" } } }, "bucket_schema_expansion_status": "BUCKET_SCHEMA_PARTIAL", "bucket_schema_expanded_at": "2026-04-28T16:02:07.115745+00:00", "bucket_schema_expansion_rule": { "source_queue": "/home/yeff/public_html/devon/docs/json/phase-02/_phase02_bucket_schema_expansion_queue.json", "bucket_count": 7, "engine_grade_final": false, "allowed_next_status": [ "BUCKET_SCHEMA_PARTIAL", "BUCKET_SCHEMA_READY" ], "not_final_reason": "checks are now bucket-scoped and schema-declared, but still require deterministic key-path resolver validation before engine_grade_final can become true" } }, "bucket_schema_status": "BUCKET_SCHEMA_PARTIAL", "updated_at": "2026-04-28T16:02:07.115767+00:00" }