infrastructure_semantica

---

iso_doc_type: "Specification" iso_viewpoint: "ComponentView" type: "module" title: "factory-infrastructure::semantica — Semantica Decision & Conflict Client" source_path: "crates/factory-infrastructure/src/semantica.rs" description: "ISO 42010 ComponentView / ISO 15289 Specification documentation for factory-infrastructure::semantica — Semantica Decision & Conflict Client." tags: ['iso42010', 'okf', 'component_view', 'rust', 'ast'] timestamp: "2026-10-01T14:00:00Z" generated: "agent:okf-professional-documenter" verified: "true" last_verified_commit: "fbdc5848"

factory-infrastructure::semantica — Semantica Decision & Conflict Client

Source: crates/factory-infrastructure/src/semantica.rs
Layer: Infrastructure
Role: HTTP adapter for the Semantica service providing decision provenance, mission plan conflict detection, and patch causal chain verification.

---

SemanticaClient Trait & Endpoints

classDiagram
    class SemanticaClient {
        <<trait>>
        +record_decision(&DecisionRecord) Result~()~
        +detect_conflicts(&MissionPlan) Result~Vec~Conflict~~
        +verify_provenance(patch_id) Result~ProvenanceReport~
    }

    class HttpSemanticaClient {
        -String endpoint
        -Option~String~ nhi_identity
        -reqwest::Client client
        +new(endpoint, nhi_identity) HttpSemanticaClient
    }

    SemanticaClient <|.. HttpSemanticaClient

Loading

Endpoints

Method	Endpoint	Description
POST	/v1/decisions	Appends an immutable decision record with AST node associations.
POST	/v1/conflicts/detect	Evaluates proposed mission tasks against architectural rules.
GET	/v1/provenance/{patch_id}	Verifies causal provenance and constitutional policy compliance.

---

Related: semantica_bridge.rs · Infrastructure Adapters