{
  "specFormat": "CycloneDX",
  "specVersion": "2.0",
  "$comment": "Generated by tools/build_perspectives.py from profile-interface-disclosure.rules.json v0.9. Informative companion: the rules file is normative.",
  "metadata": {
    "timestamp": "2026-10-25T00:00:00Z"
  },
  "perspectives": [
    {
      "bom-ref": "perspective:interface-disclosure",
      "name": "PKIC CBOM profile: Interface Disclosure Baseline (Example) v0.9",
      "description": "When a weakness is published against an algorithm, a protocol version, or a library, which of the deployed interfaces are affected — and, holding this record beside the one from last quarter, what has changed.",
      "domains": [
        "cryptographic-security"
      ],
      "mappings": [
        {
          "expression": "$.inventories[*].components[*]",
          "nativeName": "interface-disclosure#P1",
          "relevance": "required",
          "rationale": "Product declares at least one cryptographic interface"
        },
        {
          "expression": "$.inventories[*].components[*]",
          "nativeName": "interface-disclosure#P2",
          "relevance": "required",
          "rationale": "Product declares at least one management (configuration) interface, or states why it has none"
        },
        {
          "expression": "$.inventories[0].subject.identifiers",
          "nativeName": "interface-disclosure#P3",
          "relevance": "required",
          "rationale": "Document identifies the subject it describes"
        },
        {
          "expression": "$.compositions",
          "nativeName": "interface-disclosure#P4",
          "relevance": "required",
          "rationale": "Product states how complete its declared interface set is"
        },
        {
          "expression": "$.inventories[0].subject.properties[?(@.name=='pkic:profile:subjectType')]",
          "nativeName": "interface-disclosure#P5",
          "relevance": "required",
          "rationale": "Document declares which type of subject it describes, from the types the profile accepts"
        },
        {
          "expression": "$.metadata.lifecycles",
          "nativeName": "interface-disclosure#P6",
          "relevance": "required",
          "rationale": "Document declares one lifecycle stage, and every interface reports that stage"
        },
        {
          "expression": "$.inventories[*].components[?(@.cryptoProperties.assetType=='protocol')].cryptoProperties.protocolProperties.type",
          "nativeName": "interface-disclosure#I1 protocol",
          "relevance": "required",
          "rationale": "Required when interfaceType is not storage."
        },
        {
          "expression": "$.inventories[*].components[?(@.cryptoProperties.assetType=='protocol')].cryptoProperties.protocolProperties.version",
          "nativeName": "interface-disclosure#I2 protocolVersion",
          "relevance": "required",
          "rationale": "Required when interfaceType is not storage."
        },
        {
          "expression": "$.inventories[*].components[?(@.cryptoProperties.assetType=='protocol')].cryptoProperties.protocolProperties.relatedCryptographicAssets",
          "nativeName": "interface-disclosure#I3 keyExchange",
          "relevance": "required",
          "rationale": "Required when interfaceType is not storage."
        },
        {
          "expression": "$.inventories[*].components[?(@.cryptoProperties.assetType=='protocol')].cryptoProperties.protocolProperties.relatedCryptographicAssets",
          "nativeName": "interface-disclosure#I4 encryption",
          "relevance": "required",
          "rationale": "Every declared interface."
        },
        {
          "expression": "$.inventories[*].components[?(@.cryptoProperties.assetType=='protocol')].cryptoProperties.protocolProperties.relatedCryptographicAssets",
          "nativeName": "interface-disclosure#I5 authentication",
          "relevance": "required",
          "rationale": "Required when interfaceType is not storage."
        },
        {
          "expression": "$.inventories[*].components[*].properties[?(@.name=='pkic:profile:endpointRoles')]",
          "nativeName": "interface-disclosure#I6 endpointRoles",
          "relevance": "required",
          "rationale": "Required when interfaceType is not storage."
        },
        {
          "expression": "$.inventories[*].components[*].properties[?(@.name=='pkic:profile:interfaceType')]",
          "nativeName": "interface-disclosure#I7 interfaceType",
          "relevance": "required",
          "rationale": "Every declared interface."
        },
        {
          "expression": "$.metadata.lifecycles",
          "nativeName": "interface-disclosure#I8 lifecycleStage",
          "relevance": "required",
          "rationale": "Every declared interface."
        },
        {
          "expression": "$.dependencies[*].provides",
          "nativeName": "interface-disclosure#I9 implementationPurl",
          "relevance": "required",
          "rationale": "Every declared interface."
        },
        {
          "expression": "$.inventories[*].components[?(@.cryptoProperties.assetType=='related-crypto-material')].cryptoProperties.relatedCryptoMaterialProperties.securedBy",
          "nativeName": "interface-disclosure#I10 keyWrapping",
          "relevance": "required",
          "rationale": "Required when interfaceType is storage."
        },
        {
          "expression": "$.inventories[*].components[*].properties[?(@.name=='pkic:profile:defaultState')]",
          "nativeName": "interface-disclosure#I11 defaultState",
          "relevance": "recommended",
          "rationale": "Required when lifecycleStage is implemented."
        },
        {
          "expression": "$.externalReferences[?(@.properties[?(@.name=='pkic:profile:context' && @.value=='sbom')])]",
          "nativeName": "interface-disclosure#R1 sbom",
          "relevance": "required",
          "rationale": "The SBOM of the same subject, as a BOM-Link with a hash. It is how a consumer reaches components the CBOM does not describe, and how a library named under I9 is placed in the dependency tree."
        },
        {
          "expression": "$.externalReferences[?(@.properties[?(@.name=='pkic:profile:context' && @.value=='vulnerability-statements')])]",
          "nativeName": "interface-disclosure#R2 vulnerability-statements",
          "relevance": "required",
          "rationale": "Where the producer publishes statements about whether this subject is affected by a vulnerability (VEX, CSAF VEX, or an exploitability statement). Either a fixed document, with a hash, or a feed or API, with its access protocol named. A producer that publishes none says so ('not-published'). Silence"
        },
        {
          "expression": "$.externalReferences[?(@.properties[?(@.name=='pkic:profile:context' && @.value=='advisories')])]",
          "nativeName": "interface-disclosure#R3 advisories",
          "relevance": "recommended",
          "rationale": "Where third-party or vendor advisories about the subject and its libraries are published, with the access protocol named: a web page, a CSAF provider, the OSV API or the GitHub advisory API. A machine-readable endpoint lets a consumer query by the package URLs the CBOM already carries."
        },
        {
          "expression": "$.externalReferences[?(@.properties[?(@.name=='pkic:profile:context' && @.value=='security-contact')])]",
          "nativeName": "interface-disclosure#R4 security-contact",
          "relevance": "recommended",
          "rationale": "Where to report a weakness or request a fuller disclosure. The objective lists 'request a fuller disclosure from the producer' as a decision option; without a contact, that option has no address."
        },
        {
          "expression": "$.inventories[*].components[*].externalReferences[?(@.properties[?(@.name=='pkic:profile:context' && @.value=='configuration-guidance')])]",
          "nativeName": "interface-disclosure#R5 configuration-guidance",
          "relevance": "required",
          "rationale": "If a product states that the operator decides an algorithm, the interface points to where the operator decides it. 'deployment-defined' without this pointer tells the operator that the decision is theirs and not how to make it."
        },
        {
          "expression": "$.externalReferences[?(@.properties[?(@.name=='pkic:profile:context' && @.value=='design-intent')])]",
          "nativeName": "interface-disclosure#R6 design-intent",
          "relevance": "optional",
          "rationale": "A threat model or design document. This is where design intention is recorded now that 'intended' is not an accepted stage: as context the record points to, not as a stage it reports."
        }
      ],
      "externalReferences": [
        {
          "type": "documentation",
          "url": "https://pkic.github.io/cbom/methodology/profile.html"
        }
      ]
    }
  ]
}
