{ "phase_id": "phase-02", "category_id": "architecture_engineering_core", "doc_id": "card_contract_minimums", "source_path": "/home/yeff/public_html/devon/panel/data/card_contract_minimums.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-card-contract-minimums", "version": "1.0.0", "status": "ACTIVE" }, "contract_schema": { "required_blocks": [ "identity", "objective", "scope", "interfaces", "dependencies", "technology_mapping", "configuration_contract", "operational_contract", "evidence_contract", "validation_pipeline", "status_rules", "ui_contract" ] }, "identity": { "required_fields": [ "module_id", "display_name", "deployment_stage", "deployment_order", "version", "owner", "criticality", "environment_scope" ] }, "objective": { "required_fields": [ "primary_objective", "explicit_non_objectives", "failure_impact" ] }, "scope": { "required_fields": [ "in_scope", "out_of_scope", "allowed_side_effects", "prohibited_side_effects" ] }, "interfaces": { "required_fields": [ "inputs", "outputs", "events_emitted", "events_consumed", "request_schema_refs", "response_schema_refs" ] }, "dependencies": { "required_fields": [ "hard_dependencies", "soft_dependencies", "upstream_modules", "downstream_modules", "blockers" ] }, "technology_mapping": { "required_fields": [ "runtimes", "libraries", "services", "containers", "ports", "env_vars", "volumes", "files", "endpoints", "commands", "secrets", "permissions" ] }, "configuration_contract": { "required_fields": [ "required_envs", "optional_envs", "env_validation_rules", "config_files", "flags", "defaults_policy", "timeout_policy", "retry_policy", "fallback_policy", "cache_policy", "circuit_breaker_policy" ], "minimum_detail_rule": "Every minimum configuration detail that affects runtime, boot, validation, integration, execution, security or promotion must be explicitly represented here. Nothing implicit.\n" }, "operational_contract": { "required_fields": [ "startup_contract", "healthcheck_contract", "readiness_contract", "liveness_contract", "degradation_mode", "shutdown_behavior", "backup_behavior", "rollback_behavior" ] }, "evidence_contract": { "required_fields": [ "expected_files", "expected_processes", "expected_containers", "expected_ports", "expected_endpoints", "expected_logs", "expected_metrics", "expected_artifacts", "expected_outputs", "evidence_collection_method" ] }, "validation_pipeline": { "required_fields": [ "install_check", "config_check", "boot_check", "health_check", "integration_check", "functional_check", "benchmark_check", "audit_check", "rollback_check" ] }, "status_rules": { "required_fields": [ "pass_rule", "fail_rule", "missing_rule" ], "canonical_values": { "pass_rule": "evidence exists and functional validation passes", "fail_rule": "evidence exists and validation fails", "missing_rule": "evidence does not exist observably" } }, "ui_contract": { "required_fields": [ "display_group", "status_badge_source", "counters", "evidence_drawer_sections", "allowed_actions", "dependency_graph_node", "timeline_events", "last_validation_pointer" ] }, "per_card_policy": { "every_card_must_define": [ "deployment_stage", "deployment_order", "hard_dependencies", "blockers", "readiness_checks", "promotion_gate", "rollback_gate" ] } }, "transition_status": "ACTIVE_DH_MIRROR", "hardening_status": "HARDENING_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": "card_contract_minimums", "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.162608+00:00", "authority": { "authority_owner": "card_contract_minimums.json", "canonical_role": "card minimum contract authority", "authority_scope": "defines the minimum fields and evidence expectations a card must expose before DH or future panel surfaces can treat it as a valid execution/card object", "card_contract_domain": [ "minimum card fields", "card evidence contract", "card status obligations", "card rendering eligibility" ], "not_authority_for": [ "global schema ownership owned by css.md", "navigation ownership", "runtime truth ownership" ] }, "required_before": [ "card shell rendering", "scorecard generation", "future panel card enforcement" ], "hard_dependencies": [ "css.md", "panel_component_contract.json", "panel_data_contract.json" ], "feeds_operational_ui": [ "card_shell_rendering", "evidence_drawer", "status_counter", "future_panel_card_contract_reader" ], "bucket_contracts": { "Prerequisites": { "contract_role": "prove card_contract_minimums.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", "card_contract_domain" ], "validation_mode": "schema_backed_transition", "parser_readiness": "medium" }, "Installation": { "contract_role": "make card_contract_minimums 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 card_contract_minimums authority scope, dependency boundaries and forbidden ownership classes into parseable structure", "required_structural_fields": [ "authority_scope", "not_authority_for", "card_contract_domain", "boundary_rules" ], "validation_mode": "schema_backed_transition", "parser_readiness": "medium" }, "Validation": { "contract_role": "convert card_contract_minimums 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 card_contract_minimums 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 card_contract_minimums", "required_structural_fields": [ "failure_modes", "recovery_actions", "rollback_or_safe_state" ], "validation_mode": "schema_backed_transition", "parser_readiness": "medium" }, "Completion & Promotion": { "contract_role": "promote card_contract_minimums 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": "card_contract_minimums_doc_identity", "type": "exact_value", "path": "$.doc_id", "expected": "card_contract_minimums", "on_fail": "FAIL" }, { "check_id": "card_contract_minimums_category_binding", "type": "exact_value", "path": "$.category_id", "expected": "architecture_engineering_core", "on_fail": "FAIL" }, { "check_id": "card_contract_minimums_phase_binding", "type": "exact_value", "path": "$.phase_id", "expected": "phase-02", "on_fail": "FAIL" }, { "check_id": "card_contract_minimums_branch_status", "type": "exact_value", "path": "$.documentation_branch_status", "expected": "CUSTOM_BRANCH", "on_fail": "FAIL" }, { "check_id": "card_contract_minimums_authority_owner_declared", "type": "exact_value", "path": "$.structural_contract.authority.authority_owner", "expected": "card_contract_minimums.json", "on_fail": "FAIL" }, { "check_id": "card_contract_minimums_not_engine_final", "type": "exact_value", "path": "$.engine_grade_final", "expected": false, "on_fail": "FAIL" }, { "check_id": "card_contract_minimums_source_payload_object_present", "type": "object_present", "path": "$.source_payload", "on_missing": "MISSING", "on_fail": "FAIL" }, { "check_id": "card_contract_minimums_depends_on_css_md", "type": "array_contains", "path": "$.structural_contract.hard_dependencies", "expected": "css.md", "on_fail": "FAIL" }, { "check_id": "card_contract_minimums_depends_on_panel_component_contract_json", "type": "array_contains", "path": "$.structural_contract.hard_dependencies", "expected": "panel_component_contract.json", "on_fail": "FAIL" }, { "check_id": "card_contract_minimums_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/card_contract_minimums.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/card_contract_minimums.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 === \"card_contract_minimums\" && 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": "card_contract_minimums_source_missing", "status": "MISSING", "meaning": "card_contract_minimums source cannot be read from declared source path", "recovery_action": "restore /home/yeff/public_html/devon/panel/data/card_contract_minimums.json or the declared mirror source before hardening can continue" }, { "failure_id": "card_contract_minimums_unbound_from_phase02", "status": "FAIL", "meaning": "card_contract_minimums 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": "card_contract_minimums_dependency_missing", "status": "MISSING", "meaning": "card_contract_minimums cannot prove declared hard dependencies", "recovery_action": "restore declared dependencies or block promotion until dependency validation passes" }, { "failure_id": "card_contract_minimums_authority_overreach", "status": "FAIL", "meaning": "card_contract_minimums claims authority outside its declared scope", "recovery_action": "revoke overreaching authority and route the claim to the owning document or contract" }, { "failure_id": "card_contract_minimums_false_engine_promotion", "status": "FAIL", "meaning": "card_contract_minimums 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": [ "card_contract_minimums source exists materially", "card_contract_minimums is registered under Phase 02", "card_contract_minimums has a custom Documentation Hub branch", "card_contract_minimums JSON mirror contains structural_contract", "card_contract_minimums 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": "card_contract_minimums 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": "card_contract_minimums 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": "card_contract_minimums", "$.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": "card_minimums_must_be_key_bound", "meaning": "card validity must resolve from explicit source_payload keys", "fail_state": "FAIL when card minimum is prose-only" }, { "rule_id": "card_status_requires_evidence", "meaning": "card status cannot be shown without evidence field contract", "fail_state": "FAIL when status has no evidence path" } ], "required_keys": [ "source_payload" ], "schema_boundary_rules": [ { "rule_id": "card_minimums_must_be_key_bound", "meaning": "card validity must resolve from explicit source_payload keys", "fail_state": "FAIL when card minimum is prose-only" }, { "rule_id": "card_status_requires_evidence", "meaning": "card status cannot be shown without evidence field contract", "fail_state": "FAIL when status has no evidence path" } ], "source_signal_audit": { "source_payload_is_object": true, "source_payload_top_keys": [ "canon_meta", "configuration_contract", "contract_schema", "dependencies", "evidence_contract", "identity", "interfaces", "objective", "operational_contract", "per_card_policy", "scope", "status_rules", "technology_mapping", "ui_contract", "validation_pipeline" ], "audit_note": "source_signal_audit records JSON mirror shape only; structural_contract remains governed by schema key binding and Phase 02 queue" } } }