{ "phase_id": "phase-02", "category_id": "architecture_engineering_core", "doc_id": "panel_component_contract", "source_path": "/home/yeff/public_html/devon/panel/data/panel_component_contract.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-panel-component-contract", "version": "1.0.0", "status": "ACTIVE", "contract_mode": "component_level_ui_governance" }, "component_contract": { "objective": "Define the canonical visual and behavioral contract for every major UI component of the Devon Operator Panel, ensuring implementation consistency, evidence-driven rendering and deployment-order-first navigation.\n", "global_rules": [ "component_names_are_canonical", "no_fake_status_rendering", "no_mock_progress", "all_status_badges_must_bind_to_evidence", "all_navigation_must_follow_deployment_order", "all drawers must be context-aware", "every component must expose loading_empty_error_ready states", "every component must support project_scope and server_scope context", "every component must be readable in desktop first, then tablet/mobile", "no technology-first labeling in primary navigation" ], "components": [ { "component_id": "topbar_shell", "display_name": "Topbar Shell", "role": "global context and fast actions", "placement": "topbar", "required_props": [ "current_project", "current_server", "current_stage", "global_status_counters", "search_query" ], "required_slots": [ "left_cluster", "center_cluster", "right_cluster" ], "required_actions": [ "project_select", "server_select", "stage_select", "search_submit", "quick_action_trigger" ], "states": [ "loading", "ready", "empty", "error" ] }, { "component_id": "deployment_stage_tree", "display_name": "Deployment Stage Tree", "role": "primary left navigation", "placement": "left_sidebar", "required_props": [ "ordered_stage_groups", "selected_stage", "stage_status_counts" ], "required_render_fields": [ "deployment_order", "stage_label", "pass_count", "fail_count", "missing_count" ], "required_actions": [ "select_stage", "expand_stage", "collapse_stage" ], "states": [ "loading", "ready", "empty", "error" ] }, { "component_id": "content_index_links", "display_name": "Content Index Links", "role": "section/card shortcuts", "placement": "left_sidebar", "required_props": [ "content_index_items", "selected_section", "selected_card" ], "required_render_fields": [ "nav_id", "label", "target_section", "primary_card_ids" ], "required_actions": [ "jump_to_section", "jump_to_card" ], "states": [ "loading", "ready", "empty", "error" ] }, { "component_id": "status_counter_strip", "display_name": "Status Counter Strip", "role": "global PASS FAIL MISSING visibility", "placement": "topbar", "required_props": [ "total_items", "pass_count", "fail_count", "missing_count", "by_stage_counts" ], "required_render_fields": [ "total_items", "pass_count", "fail_count", "missing_count" ], "required_actions": [ "filter_pass", "filter_fail", "filter_missing" ], "states": [ "loading", "ready", "empty", "error" ] }, { "component_id": "card_grid", "display_name": "Card Grid", "role": "render cards by selected stage/section", "placement": "center_workspace", "required_props": [ "selected_stage", "selected_section", "card_rows" ], "required_render_fields": [ "card_id", "display_name", "subcategory", "objective", "status", "dependency_count", "evidence_count" ], "required_actions": [ "open_card", "open_contract", "open_evidence", "open_dependencies", "open_timeline" ], "states": [ "loading", "ready", "empty", "error" ] }, { "component_id": "workspace_tabs", "display_name": "Workspace Tabs", "role": "center view switching", "placement": "center_workspace", "required_props": [ "available_tabs", "active_tab", "selected_context" ], "required_render_fields": [ "tab_id", "label" ], "required_actions": [ "switch_tab" ], "states": [ "loading", "ready", "empty", "error" ] }, { "component_id": "workspace_header", "display_name": "Workspace Header", "role": "selected context summary", "placement": "center_workspace", "required_props": [ "current_section_title", "current_card_title", "current_subcategory_title", "current_status_badge", "breadcrumb" ], "required_render_fields": [ "current_section_title", "current_card_title", "current_subcategory_title", "current_status_badge", "breadcrumb" ], "required_actions": [ "breadcrumb_jump", "status_badge_click" ], "states": [ "loading", "ready", "empty", "error" ] }, { "component_id": "preview_panel", "display_name": "Preview Panel", "role": "default primary visual output", "placement": "center_workspace", "required_props": [ "selected_context", "selected_matrix_row" ], "required_render_fields": [ "display_name", "objective", "status", "summary" ], "required_actions": [ "expand_preview", "open_artifact" ], "states": [ "loading", "ready", "empty", "error" ] }, { "component_id": "artifact_panel", "display_name": "Artifact Panel", "role": "artifact visualization", "placement": "center_workspace", "required_props": [ "artifact_ref", "artifact_type", "artifact_content" ], "required_render_fields": [ "artifact_ref", "artifact_type" ], "required_actions": [ "copy_artifact", "open_diff" ], "states": [ "loading", "ready", "empty", "error" ] }, { "component_id": "contract_panel", "display_name": "Contract Panel", "role": "show canonical contract blocks", "placement": "center_workspace", "required_props": [ "contract_ref", "contract_blocks" ], "required_render_fields": [ "required_blocks", "identity", "interfaces", "dependencies", "configuration_contract", "operational_contract", "evidence_contract", "validation_pipeline", "status_rules" ], "required_actions": [ "expand_block", "collapse_block", "copy_contract_ref" ], "states": [ "loading", "ready", "empty", "error" ] }, { "component_id": "diff_panel", "display_name": "Diff Panel", "role": "change inspection", "placement": "center_workspace", "required_props": [ "diff_content", "diff_source", "diff_target" ], "required_render_fields": [ "diff_source", "diff_target" ], "required_actions": [ "expand_diff", "copy_diff" ], "states": [ "loading", "ready", "empty", "error" ] }, { "component_id": "logs_panel", "display_name": "Logs Panel", "role": "runtime and validation logs", "placement": "center_workspace", "required_props": [ "log_entries", "log_scope" ], "required_render_fields": [ "timestamp", "source", "level", "message" ], "required_actions": [ "filter_logs", "expand_log" ], "states": [ "loading", "ready", "empty", "error" ] }, { "component_id": "metrics_panel", "display_name": "Metrics Panel", "role": "runtime metrics and counters", "placement": "center_workspace", "required_props": [ "metric_series", "metric_scope" ], "required_render_fields": [ "metric_name", "metric_value", "metric_unit" ], "required_actions": [ "filter_metrics", "expand_metric" ], "states": [ "loading", "ready", "empty", "error" ] }, { "component_id": "timeline_panel", "display_name": "Timeline Panel", "role": "validation promotion rollback sequence", "placement": "center_workspace", "required_props": [ "timeline_events", "timeline_scope" ], "required_render_fields": [ "timestamp", "event_type", "event_status", "event_summary" ], "required_actions": [ "expand_event", "filter_timeline" ], "states": [ "loading", "ready", "empty", "error" ] }, { "component_id": "evidence_drawer", "display_name": "Evidence Drawer", "role": "primary right-side evidence context", "placement": "right_stack", "required_props": [ "evidence_expected", "evidence_found", "checks", "current_status", "last_validation" ], "required_render_fields": [ "evidence_expected", "checks", "current_status", "last_validation" ], "required_actions": [ "expand_evidence", "open_check_details", "filter_same_status" ], "states": [ "loading", "ready", "empty", "error" ] }, { "component_id": "contract_drawer", "display_name": "Contract Drawer", "role": "quick contract summary", "placement": "right_stack", "required_props": [ "contract_ref", "required_blocks", "configuration_contract", "operational_contract" ], "required_render_fields": [ "contract_ref", "required_blocks" ], "required_actions": [ "open_full_contract", "copy_contract_ref" ], "states": [ "loading", "ready", "empty", "error" ] }, { "component_id": "dependency_drawer", "display_name": "Dependency Drawer", "role": "show blockers and hard dependencies", "placement": "right_stack", "required_props": [ "hard_dependencies", "blockers", "upstream", "downstream" ], "required_render_fields": [ "hard_dependencies", "blockers" ], "required_actions": [ "open_dependency_node", "filter_blocked_items" ], "states": [ "loading", "ready", "empty", "error" ] }, { "component_id": "memory_scope_drawer", "display_name": "Memory Scope Drawer", "role": "show memory routing context", "placement": "right_stack", "required_props": [ "memory_partition_class", "routing_keys", "read_policy", "write_policy" ], "required_render_fields": [ "memory_partition_class", "routing_keys", "read_policy", "write_policy" ], "required_actions": [ "open_memory_contract", "inspect_routing_keys" ], "states": [ "loading", "ready", "empty", "error" ] }, { "component_id": "server_scope_drawer", "display_name": "Server Scope Drawer", "role": "show server execution context", "placement": "right_stack", "required_props": [ "server_id", "role", "allowed_projects", "sandbox_capable", "promotion_capable" ], "required_render_fields": [ "server_id", "role", "allowed_projects", "sandbox_capable", "promotion_capable" ], "required_actions": [ "open_server_contract", "inspect_allowed_projects" ], "states": [ "loading", "ready", "empty", "error" ] }, { "component_id": "validation_drawer", "display_name": "Validation Drawer", "role": "show validation pipeline status", "placement": "right_stack", "required_props": [ "pipeline_ref", "validation_steps", "current_validation_state" ], "required_render_fields": [ "pipeline_ref", "validation_steps", "current_validation_state" ], "required_actions": [ "open_pipeline", "inspect_step" ], "states": [ "loading", "ready", "empty", "error" ] } ], "component_binding_rules": { "selected_stage_source": "11_panel_content_index.yaml", "selected_card_source": "02_panel_canonical_tree.yaml", "matrix_row_source": "08_canonical_matrix_v1.yaml", "contract_source": "03_card_contract_minimums.yaml", "memory_source": "04_memory_canonical_architecture.yaml", "server_source": "05_server_registry_canonical.yaml", "sandbox_source": "06_sandbox_environment_canonical.yaml", "pipeline_source": "07_subcategory_pipelines.yaml" }, "required_ui_states": [ "loading", "ready", "empty", "error" ], "responsive_policy": { "desktop": "three_column_workspace", "tablet": "overlay_side_panels", "mobile": "stacked_workspace_with_offcanvas_side_panels" }, "implementation_gate": { "frontend_may_start_only_if": [ "10_panel_data_contract.yaml exists", "11_panel_content_index.yaml exists", "12_panel_ui_blueprint.yaml exists", "13_panel_component_contract.yaml exists" ] } } }, "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": "panel_component_contract", "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.165322+00:00", "authority": { "authority_owner": "panel_component_contract.json", "canonical_role": "panel component contract authority", "authority_scope": "defines the component-level contract between category data, rendering components, evidence drawers and status behavior before the future panel renders executable controls", "panel_component_domain": [ "component interface", "rendering input contract", "drawer wiring", "component status behavior" ], "not_authority_for": [ "data payload sovereignty", "sync protocol ownership", "navigation structure" ] }, "required_before": [ "panel component rendering", "evidence drawers", "future panel component runtime" ], "hard_dependencies": [ "css.md", "panel_data_contract.json" ], "feeds_operational_ui": [ "component_shell", "evidence_drawer", "status_badges", "future_panel_component_contract_reader" ], "bucket_contracts": { "Prerequisites": { "contract_role": "prove panel_component_contract.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", "panel_component_domain" ], "validation_mode": "schema_backed_transition", "parser_readiness": "medium" }, "Installation": { "contract_role": "make panel_component_contract 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 panel_component_contract authority scope, dependency boundaries and forbidden ownership classes into parseable structure", "required_structural_fields": [ "authority_scope", "not_authority_for", "panel_component_domain", "boundary_rules" ], "validation_mode": "schema_backed_transition", "parser_readiness": "medium" }, "Validation": { "contract_role": "convert panel_component_contract 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 panel_component_contract 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 panel_component_contract", "required_structural_fields": [ "failure_modes", "recovery_actions", "rollback_or_safe_state" ], "validation_mode": "schema_backed_transition", "parser_readiness": "medium" }, "Completion & Promotion": { "contract_role": "promote panel_component_contract 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": "panel_component_contract_doc_identity", "type": "exact_value", "path": "$.doc_id", "expected": "panel_component_contract", "on_fail": "FAIL" }, { "check_id": "panel_component_contract_category_binding", "type": "exact_value", "path": "$.category_id", "expected": "architecture_engineering_core", "on_fail": "FAIL" }, { "check_id": "panel_component_contract_phase_binding", "type": "exact_value", "path": "$.phase_id", "expected": "phase-02", "on_fail": "FAIL" }, { "check_id": "panel_component_contract_branch_status", "type": "exact_value", "path": "$.documentation_branch_status", "expected": "CUSTOM_BRANCH", "on_fail": "FAIL" }, { "check_id": "panel_component_contract_authority_owner_declared", "type": "exact_value", "path": "$.structural_contract.authority.authority_owner", "expected": "panel_component_contract.json", "on_fail": "FAIL" }, { "check_id": "panel_component_contract_not_engine_final", "type": "exact_value", "path": "$.engine_grade_final", "expected": false, "on_fail": "FAIL" }, { "check_id": "panel_component_contract_source_payload_object_present", "type": "object_present", "path": "$.source_payload", "on_missing": "MISSING", "on_fail": "FAIL" }, { "check_id": "panel_component_contract_depends_on_css_md", "type": "array_contains", "path": "$.structural_contract.hard_dependencies", "expected": "css.md", "on_fail": "FAIL" }, { "check_id": "panel_component_contract_depends_on_panel_data_contract_json", "type": "array_contains", "path": "$.structural_contract.hard_dependencies", "expected": "panel_data_contract.json", "on_fail": "FAIL" } ], "evidence_paths": [ "/home/yeff/public_html/devon/panel/data/panel_component_contract.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/panel_component_contract.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 === \"panel_component_contract\" && 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": "panel_component_contract_source_missing", "status": "MISSING", "meaning": "panel_component_contract source cannot be read from declared source path", "recovery_action": "restore /home/yeff/public_html/devon/panel/data/panel_component_contract.json or the declared mirror source before hardening can continue" }, { "failure_id": "panel_component_contract_unbound_from_phase02", "status": "FAIL", "meaning": "panel_component_contract 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": "panel_component_contract_dependency_missing", "status": "MISSING", "meaning": "panel_component_contract cannot prove declared hard dependencies", "recovery_action": "restore declared dependencies or block promotion until dependency validation passes" }, { "failure_id": "panel_component_contract_authority_overreach", "status": "FAIL", "meaning": "panel_component_contract claims authority outside its declared scope", "recovery_action": "revoke overreaching authority and route the claim to the owning document or contract" }, { "failure_id": "panel_component_contract_false_engine_promotion", "status": "FAIL", "meaning": "panel_component_contract 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": [ "panel_component_contract source exists materially", "panel_component_contract is registered under Phase 02", "panel_component_contract has a custom Documentation Hub branch", "panel_component_contract JSON mirror contains structural_contract", "panel_component_contract 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": "panel_component_contract 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": "panel_component_contract 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": "panel_component_contract", "$.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": "component_inputs_must_be_declared", "meaning": "component inputs must be contract-backed", "fail_state": "FAIL when component reads undeclared data" }, { "rule_id": "component_state_not_runtime_truth", "meaning": "component state may display but cannot define runtime truth", "fail_state": "FAIL when component UI becomes authority" } ], "required_keys": [ "source_payload" ], "schema_boundary_rules": [ { "rule_id": "component_inputs_must_be_declared", "meaning": "component inputs must be contract-backed", "fail_state": "FAIL when component reads undeclared data" }, { "rule_id": "component_state_not_runtime_truth", "meaning": "component state may display but cannot define runtime truth", "fail_state": "FAIL when component UI becomes authority" } ], "source_signal_audit": { "source_payload_is_object": true, "source_payload_top_keys": [ "canon_meta", "component_contract" ], "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": "panel_component_contract_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": "panel_component_contract_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": "panel_component_contract_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": "panel_component_contract_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": "panel_component_contract_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": "panel_component_contract_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": "panel_component_contract_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": "panel_component_contract_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": "panel_component_contract_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": "panel_component_contract_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": "panel_component_contract_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": "panel_component_contract_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": "panel_component_contract_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": "panel_component_contract_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": "panel_component_contract_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": "panel_component_contract_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": "panel_component_contract_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": "panel_component_contract_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/panel_component_contract.json", "$.structural_contract.expected_bindings", "$.structural_contract.source_signal_audit" ], "schema_checks": [ { "check_id": "panel_component_contract_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": "panel_component_contract_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/panel_component_contract.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": "panel_component_contract_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": "panel_component_contract_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": "panel_component_contract_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": "panel_component_contract_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": "panel_component_contract_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": "panel_component_contract_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": "panel_component_contract_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": "panel_component_contract_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": "panel_component_contract_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": "panel_component_contract_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": "panel_component_contract_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.099455+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.099480+00:00" }