{ "phase_id": "phase-02", "category_id": "architecture_engineering_core", "doc_id": "acs", "source_path": "/home/yeff/public_html/devon/panel/data/acs.md", "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": { "source_format": "markdown", "raw_markdown": "# ACS — ARTIFACT CANON SPEC\nversion: v1.0\nstatus: ACTIVE\nparent: master_architecture_index.md\nphase: 02\nphase_name: Architecture & Engineering Canon\ndocument_role: artifact_canon_standard_for_phase_02\n\n---\n\n## 1. OBJECTIVE\n\nDefine where canonical artifacts live, how they are classified, and how they relate to governance, runtime, UI and operational flows.\n\n---\n\n## 2. ARTIFACT CLASSES\n\nCanonical artifact classes:\n- governance_spec\n- architecture_spec\n- security_spec\n- performance_spec\n- observability_spec\n- flow_spec\n- runtime_contract\n- registry\n- canonical_json\n- ui_mapping\n- audit_evidence\n\n---\n\n## 3. CANONICAL ROOT\n\nPrimary canonical root:\n`/home/yeff/public_html/devon/panel/data/`\n\nPrimary master reference:\n`/home/yeff/public_html/devon/panel/data/master_architecture_index.md`\n\n---\n\n## 4. PLACEMENT RULE\n\nArtifacts that govern architecture, execution, contracts or panel structure must live under `panel/data`.\n\nArtifacts must not be scattered across unrelated folders without canon update.\n\n---\n\n## 5. SOURCE OF TRUTH RULE\n\nAuthority order:\n1. master_architecture_index.md\n2. canonical json roots\n3. canonical md specs\n4. phase-specific specs\n5. OFS files\n6. UI mapping layer\n\nLower layers must not contradict upper layers.\n\n---\n\n## 6. ARTIFACT METADATA\n\nEvery canonical artifact must expose:\n- identity\n- role\n- phase\n- parent\n- status\n- purpose\n- traceability target\n\n---\n\n## 7. TRACEABILITY RULE\n\nEvery UI-facing label, runtime contract or flow reference must resolve back to one canonical artifact.\n\nNo orphan artifact allowed.\n\n---\n\n## 8. ACCEPTANCE CRITERIA\n\nACS is valid only if:\n- canonical root is explicit\n- artifact classes are explicit\n- authority order is explicit\n- placement rule is explicit\n- traceability rule is explicit\n" }, "transition_status": "ACTIVE_DH_MIRROR", "hardening_status": "HARDENING_PARTIAL", "engine_grade_final": false, "validation_mode": "schema_backed_transition", "parser_readiness": "medium", "hardening_priority": "extract_structural_fields_from_dh_text", "structural_contract": { "hardening_status": "HARDENING_PARTIAL", "engine_grade_final": false, "transition_status": "ACTIVE_DH_MIRROR", "doc_id": "acs", "category_id": "architecture_engineering_core", "phase_id": "phase-02", "hardening_lane": "dh_text_to_structural_contract", "patch_type": "extract_structural_fields", "created_at": "2026-04-28T15:31:55.937362+00:00", "authority": { "authority_owner": "acs.md", "canonical_role": "artifact structure authority", "authority_scope": "governs how Devon canonical artifacts are shaped, separated, registered, related and exposed as valid structural objects after governance rules exist and before schemas, contracts, DH mirrors or panel consumers can rely on them", "artifact_decision_domain": [ "artifact class separation", "authority versus satellite boundary", "canonical artifact registration", "structured JSON placement", "documentation-to-machine mirror eligibility", "dependent artifact coherence" ], "not_authority_for": [ "cognitive architecture definition owned by cas.md", "governance rule ownership owned by cgs.md", "schema/interface field law owned by css.md", "naming convention ownership owned by ncs.md", "state legitimacy ownership owned by sts.md", "runtime evidence ownership" ] }, "required_before": [ "structured json artifacts", "DH/UI artifact mapping", "contracts and schema hardening", "future Panel de Execução e Monitoramento artifact views", "IA Devon artifact consumption and artifact provenance checks" ], "hard_dependencies": [ "cgs.md", "master_architecture_index.md" ], "feeds_operational_ui": [ "artifact_view", "contract_view", "validation_timeline", "evidence_drawer", "future_panel_artifact_registry_reader" ], "bucket_contracts": { "Prerequisites": { "contract_role": "prove artifact authority exists before the panel accepts any DH mirror, JSON contract or structured support file as a coherent artifact", "required_structural_fields": [ "authority_owner", "canonical_role", "required_before", "hard_dependencies", "artifact_decision_domain" ], "validation_mode": "schema_backed_transition", "parser_readiness": "medium" }, "Installation": { "contract_role": "make ACS available in DH as the structural authority that tells the future panel where artifact classes belong and how they are exposed", "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": "separate authority files, satellite files, structured canonical JSON, runtime/support JSON and DH mirror JSON so artifact meaning cannot be mixed by presentation convenience", "required_structural_fields": [ "artifact_classes", "authority_scope", "not_authority_for", "artifact_boundary_rules" ], "validation_mode": "schema_backed_transition", "parser_readiness": "medium" }, "Validation": { "contract_role": "convert artifact structure into deterministic checks for registration, class placement, dependency coherence and boundary violations", "required_structural_fields": [ "validation_checks", "pass_criteria", "fail_criteria", "missing_criteria" ], "validation_mode": "schema_backed_transition", "parser_readiness": "medium" }, "Observable Evidence": { "contract_role": "show material files, DH branch binding, JSON mirror path and master registration proving ACS can govern artifact structure", "required_structural_fields": [ "evidence_paths", "expected_bindings", "observable_checks" ], "validation_mode": "schema_backed_transition", "parser_readiness": "medium" }, "Failure Modes & Recovery": { "contract_role": "recover artifact overlap, orphan artifacts, wrong class placement, authority/satellite mixing and mirror promotion before panel artifact consumers trust bad structure", "required_structural_fields": [ "failure_modes", "recovery_actions", "rollback_or_safe_state" ], "validation_mode": "schema_backed_transition", "parser_readiness": "medium" }, "Completion & Promotion": { "contract_role": "promote ACS only when artifact classes, boundaries, evidence paths and downstream UI consumption rules are parseable enough to guide the future panel", "required_structural_fields": [ "done_when", "not_done_when", "promotion_gate", "canonization_gate" ], "validation_mode": "schema_backed_transition", "parser_readiness": "medium" } }, "artifact_classes": [ { "class_id": "authority_markdown", "purpose": "human-readable sovereign or bounded authority document", "examples": [ "cas.md", "cgs.md", "acs.md", "css.md", "ncs.md", "sts.md" ], "boundary": "may define canonical meaning when registered as authority in master_architecture_index.md" }, { "class_id": "satellite_markdown", "purpose": "contextual reference that can support but cannot redefine a sovereign authority", "examples": [ "ris.md", "ofms.md" ], "boundary": "may contextualize relationships, roles or flow support but cannot override authority owner" }, { "class_id": "structured_canonical_json", "purpose": "machine-readable canonical or support contract artifact", "examples": [ "panel_data_contract.json", "panel_component_contract.json", "panel_sync_contract.json", "canonical_matrix_v1.json" ], "boundary": "may enforce declared structure but cannot invent authority not registered in master" }, { "class_id": "runtime_support_json", "purpose": "observable runtime/support state emitted by operational systems", "examples": [ "runtime_status.json", "host_runtime.json", "docker_runtime.json" ], "boundary": "may report state but cannot redefine canon" }, { "class_id": "dh_mirror_json", "purpose": "machine-readable mirror of DH execution contract during transition", "examples": [ "/home/yeff/public_html/devon/docs/json/phase-02/acs.json" ], "boundary": "ACTIVE_DH_MIRROR until structural evidence, parseable validation and deterministic fail state remove prose dependence" } ], "artifact_boundary_rules": [ { "rule_id": "authority_not_satellite", "meaning": "authority markdown may own canonical meaning; satellite markdown may not", "fail_state": "FAIL when a satellite file redefines an authority owner" }, { "rule_id": "json_not_unregistered_sovereignty", "meaning": "structured JSON may enforce registered structure but cannot create sovereign canon by itself", "fail_state": "FAIL when JSON claims ownership absent from master_architecture_index.md" }, { "rule_id": "runtime_not_canon", "meaning": "runtime/support JSON may expose material state but cannot rewrite documentary authority", "fail_state": "FAIL when runtime record overrides canonical process definition" }, { "rule_id": "dh_mirror_not_engine_final", "meaning": "category JSON mirrors remain transitional until schema-backed checks replace human semantic reading", "fail_state": "FAIL when ACTIVE_DH_MIRROR is presented as final engine-grade contract" } ], "validation_checks": [ { "check_id": "acs_doc_identity", "type": "exact_value", "path": "$.doc_id", "expected": "acs", "on_fail": "FAIL" }, { "check_id": "acs_category_binding", "type": "exact_value", "path": "$.category_id", "expected": "architecture_engineering_core", "on_fail": "FAIL" }, { "check_id": "acs_phase_binding", "type": "exact_value", "path": "$.phase_id", "expected": "phase-02", "on_fail": "FAIL" }, { "check_id": "acs_branch_status", "type": "exact_value", "path": "$.documentation_branch_status", "expected": "CUSTOM_BRANCH", "on_fail": "FAIL" }, { "check_id": "acs_source_markdown_present", "type": "non_empty_string", "path": "$.source_payload.raw_markdown", "on_missing": "MISSING", "on_fail": "FAIL" }, { "check_id": "acs_authority_owner_declared", "type": "exact_value", "path": "$.structural_contract.authority.authority_owner", "expected": "acs.md", "on_fail": "FAIL" }, { "check_id": "acs_depends_on_cgs", "type": "array_contains", "path": "$.structural_contract.hard_dependencies", "expected": "cgs.md", "on_fail": "FAIL" }, { "check_id": "acs_has_artifact_classes", "type": "min_array_length", "path": "$.structural_contract.artifact_classes", "minimum": 5, "on_missing": "MISSING", "on_fail": "FAIL" }, { "check_id": "acs_not_engine_final", "type": "exact_value", "path": "$.engine_grade_final", "expected": false, "on_fail": "FAIL" } ], "evidence_paths": [ "/home/yeff/public_html/devon/panel/data/acs.md", "/home/yeff/public_html/devon/panel/data/cgs.md", "/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/acs.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 === \"acs\" && state.categoryId === \"architecture_engineering_core\")" }, { "binding": "hub_index_phase", "expected_phase_id": "phase-02" }, { "binding": "hub_index_category", "expected_category_id": "architecture_engineering_core" }, { "binding": "upstream_dependency", "expected_dependency": "cgs.md" } ], "failure_modes": [ { "failure_id": "acs_source_missing", "status": "MISSING", "meaning": "ACS source markdown cannot be read from the declared source path", "recovery_action": "restore /home/yeff/public_html/devon/panel/data/acs.md before artifact structure hardening can continue" }, { "failure_id": "acs_unbound_from_phase02", "status": "FAIL", "meaning": "ACS is present but not bound to Phase 02 Architecture & Engineering Canon", "recovery_action": "restore hub_index and docs/index binding to phase-02 / architecture_engineering_core" }, { "failure_id": "artifact_class_missing", "status": "FAIL", "meaning": "ACS cannot separate authority markdown, satellite markdown, structured JSON, runtime support JSON and DH mirror JSON", "recovery_action": "restore artifact_classes and artifact_boundary_rules before panel artifact views consume the mirror" }, { "failure_id": "authority_satellite_mixed", "status": "FAIL", "meaning": "a contextual or satellite artifact is being treated as a sovereign authority", "recovery_action": "rebind the artifact as satellite support and restore the owning authority from master_architecture_index.md" }, { "failure_id": "json_claims_unregistered_sovereignty", "status": "FAIL", "meaning": "a JSON artifact claims canonical ownership without master registration", "recovery_action": "either register the authority in master_architecture_index.md or downgrade the JSON to support/mirror status" }, { "failure_id": "artifact_promoted_without_schema_backing", "status": "FAIL", "meaning": "ACS mirror or dependent artifact is being promoted as engine-grade without deterministic structural checks", "recovery_action": "return to ACTIVE_DH_MIRROR / HARDENING_PARTIAL and require schema-backed validation before promotion" } ], "promotion_gates": { "done_when": [ "ACS source exists materially", "ACS is registered under Phase 02", "ACS has a custom Documentation Hub branch", "ACS JSON mirror contains structural_contract", "ACS depends on CGS and master_architecture_index", "ACS exposes artifact_classes and artifact_boundary_rules as parseable fields", "ACS separates authority markdown, satellite markdown, structured JSON, runtime support JSON and DH mirror JSON" ], "not_done_when": [ "source markdown is missing", "ACS category binding is wrong", "CGS dependency is absent", "artifact classes are absent", "authority and satellite artifacts are mixed", "runtime/support JSON is treated as sovereign canon", "engine_grade_final is set true before deterministic schema validation exists" ], "promotion_gate": "ACS may move from ACTIVE_DH_MIRROR to HARDENING_PARTIAL after structural_contract exists and verifies, but must not become engine_grade_final until artifact class boundaries and dependency coherence are fully schema-backed.", "canonization_gate": "ACS remains canonical DH mirror until artifact classes, authority boundaries, evidence paths, failure modes and promotion gates can be consumed without semantic prose interpretation." }, "parser_readiness_after_patch": "medium", "blocked_until_engine_grade_final": [ "all artifact class checks resolve from JSON key paths", "authority/satellite violations produce deterministic FAIL", "missing artifact class produces deterministic MISSING or FAIL according to declared check", "runtime/support JSON cannot be misread as canonical authority", "future operational panel can consume ACS without reading source prose" ], "source_signal_audit": { "raw_markdown_contains_artifact_terms": true, "raw_markdown_contains_boundary_terms": true, "matched_artifact_lines_sample": [ "# ACS — ARTIFACT CANON SPEC", "document_role: artifact_canon_standard_for_phase_02", "Define where canonical artifacts live, how they are classified, and how they relate to governance, runtime, UI and operational flows.", "## 2. ARTIFACT CLASSES", "Canonical artifact classes:", "- registry", "- canonical_json", "## 3. CANONICAL ROOT", "Primary canonical root:", "Artifacts that govern architecture, execution, contracts or panel structure must live under `panel/data`.", "Artifacts must not be scattered across unrelated folders without canon update.", "## 5. SOURCE OF TRUTH RULE", "2. canonical json roots", "3. canonical md specs", "## 6. ARTIFACT METADATA", "Every canonical artifact must expose:", "Every UI-facing label, runtime contract or flow reference must resolve back to one canonical artifact.", "No orphan artifact allowed.", "- canonical root is explicit", "- artifact classes are explicit" ], "matched_boundary_lines_sample": [ "Authority order:", "- authority order is explicit" ], "audit_note": "source_signal_audit is evidence support only; structural_contract remains governed by Phase 02 queue, hub binding and canonical master registration" } } }