> ## Documentation Index
> Fetch the complete documentation index at: https://docs.githits.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Download a completed lockfile analysis

> Download the completed document in the format selected at submission. Only state=succeeded indicates that the result is ready. The response format is determined by the upstream's allowlisted media type; Accept does not select it. SBOM uses the same format-specific validation as synchronous /v1/experimental/sbom. Audit JSON receives complete syntax and version-aware envelope validation, preserving original evidence bytes. Version 2 contains compact findings, source paths, duplicate requirement origins and explicit coverage gaps. Opt-in version 3 replaces legacy deprecated lists and coverage with canonical native lifecycle findings, attributed observations and exact paths, retained legacy warnings, independent coverage and unknowns. summary.lifecycle and summary.retained_lifecycle_warnings are not vulnerability counts. Unknown native checks contribute to incomplete_checks; not_collected and not_applicable are collection limits. Package-wide version is null, and source_version need not equal an affected release. Retained versions 1 and 2 remain readable; versions 4 and newer remain opaque. Always dispatch on returned schema_version. Results are bounded to 16,777,216 bytes. Pending jobs return 409 ANALYSIS_PENDING. Failed jobs return 409 ANALYSIS_FAILED with a producer failure_code from an open vocabulary and a fixed safe detail; backend diagnostics are not returned. After authentication, malformed, missing, expired and other-owner job IDs produce the same 404 ANALYSIS_NOT_FOUND response; 400 remains for other invalid request syntax.



## OpenAPI

````yaml https://api.githits.dev/v1/openapi.json get /v1/experimental/lockfile-jobs/{id}/result
openapi: 3.1.0
info:
  description: >-
    Explore package metadata, security advisories, dependencies, documentation
    and source code with the GitHits API.


    ## Choose an operation


    | Task | Operations |

    | --- | --- |

    | Inspect a package | Release metadata, vulnerabilities and dependencies |

    | Review releases or upgrades | Changelog and batch upgrade reviews |

    | Read documentation or source code | Browse with list, then follow an exact
    action through the unified read operation |

    | Browse known content | List source files, local documentation, or an
    explicit hosted site |

    | Find exact text | Grep across ordered packages, repositories and hosted
    sites, then follow exact read actions |

    | Compare source trees | Compare files, line statistics and patches between
    package versions or repository refs |

    | Discover relevant content | Search across packages, repositories and
    documentation sites; retrieve a search's status and retained results |

    | Resolve a target name | Find ranked package, repository and
    documentation-site targets |

    | Research a cited question | Generate an answer grounded in a package,
    repository or documentation site, or continue a conversation |

    | Generate an example | Generate and save a code example, then submit
    feedback |

    | Report dependency licenses | Upload manifests/lockfiles or use a completed
    analysis to read license choices, source observations and coverage for each
    reported entry |

    | Generate an SBOM | Upload manifests and lockfiles to receive a CycloneDX,
    SPDX or text inventory |

    | Compare dependency snapshots | Submit an explicit base/head pair, follow
    shared analysis status/SSE, then download source-local changes and
    independent analysis coverage |

    | Audit lockfiles | Submit asynchronous audit analysis, follow status or
    SSE, then download findings and independent coverage as JSON |

    | Find a language identifier | Search supported programming languages |


    ## Authenticate and send requests


    The production API origin is `https://api.githits.dev`. Examples target
    production. Replace `<token>` with your GitHits token. Send the token in
    `Authorization: Bearer <token>`. JSON request bodies use `Content-Type:
    application/json`; public JSON field names use `snake_case`. Standard SBOM
    documents and embedded standard objects in licenses reports retain their
    format's field names.


    Percent-encode path parameters such as package names as one path segment,
    including any embedded slash. The unified read target is a query value:
    encode a literal plus sign as `%2B` and a literal fragment marker as `%23`;
    ordinary form decoding interprets `+` as a space. Each operation documents
    its accepted parameters and encoding rules.


    ## Select the data you need


    Where supported, `fields` is a comma-separated **query parameter**,
    including on POST requests. Omit it to use the operation's defaults.
    Supplying it replaces those defaults; required identity and information
    needed to interpret the result remain present.


    A **selector** names a supported **group** of response fields. Groups are
    atomic: their members are selected together. A **wildcard bundle**, such as
    `vulnerabilities.*`, selects only the groups listed for that bundle. A bare
    group does not automatically include nested groups. Arbitrary subfields and
    undeclared wildcards are not supported.


    Each operation lists its selectors, defaults, dependencies and the data they
    return. Selection can reduce transferred data without reducing the work
    needed to produce it; consult its parameter and response field
    documentation. Small fixed responses do not offer `fields`.


    ## Interpret responses and errors


    An omitted optional field can mean unselected or unavailable data, according
    to the operation's contract. Null has an operation-specific meaning: it can
    mark unavailable or inapplicable data, or an unselected search result. Empty
    arrays, zero and false are values, not substitutes for unavailable data.
    Always retain the result's completeness and freshness information when
    displaying or processing it.


    **Requested** identity records caller intent; **resolved** identity records
    what that intent resolved to; **served** identity identifies the artifact
    that produced the response. These can differ while indexing or refresh work
    continues. Use served identity when an exact follow-up read is required,
    preserving package-relative or repository-relative path scope.


    Errors normally use `application/problem+json`. Branch on the stable `code`,
    not the human-readable `detail`. Include `X-Request-ID` when reporting a
    problem; error `instance` matches that ID. Respect `Retry-After` when
    present. If request identity cannot be created, the response is an empty
    HTTP 500 without a request ID. Responses use `Cache-Control: no-store`; job
    events use `no-store, no-transform` to preserve streaming.


    When available, successful and rate-limited responses from operations that
    document them include `X-RateLimit-Limit`, `X-RateLimit-Remaining` and
    `X-RateLimit-Reset` for the shared usage window. All three header values
    must be available; a credential type alone does not guarantee these headers.
    Reset is an absolute Unix epoch timestamp in seconds (UTC), rounded up, not
    a delay. These snapshots support pacing; concurrent requests and other
    quotas can still cause 429. Honor `Retry-After` when supplied. The trio is
    omitted when usage metadata is unavailable, and is not exposed for generated
    examples, Research, feedback, language discovery, SBOM/licenses generation
    and licenses views, or job submission, events and results.


    Timeouts do not guarantee that work stopped. Read the documented timeout
    responses, especially for Research, generated examples and append-only
    feedback. Optional `X-GitHits-*` request headers attribute client, agent and
    session usage. The OpenAPI extension `x-githits-cost` is provisional
    operation metadata, not a price or a measure of computation.


    ## Contract status


    This API is pre-production. The external v1 contract is not yet frozen.
  license:
    name: Proprietary
  title: GitHits Public API
  version: 0.1.0
servers:
  - description: Production
    url: https://api.githits.dev
security: []
tags:
  - description: >-
      Current source-advisory evidence by ID, independent of package-version
      assessment.
    name: Vulnerabilities
  - description: >-
      Find exact text across ordered source and hosted-documentation scopes,
      check coverage, and follow exact reads.
    name: Grep
  - description: >-
      Browse package, repository or hosted-site paths and follow exact read and
      browse actions.
    name: List
  - description: >-
      Package metadata, release history, vulnerabilities, dependency graphs and
      upgrade comparisons. Each operation documents its registry, version and
      evidence scope.
    name: Packages
  - description: >-
      Read an exact documentation page or source file and retain the page,
      package-version or repository-commit details needed to cite it.
    name: Read
  - description: >-
      Discover evidence across package, repository and documentation-site
      targets, then retrieve retained search results and progress.
    name: Search
  - description: >-
      Find supported programming-language names and aliases for example
      requests.
    name: Languages
  - description: >-
      Generate code examples for programming tasks, with source references and
      license attribution.
    name: Examples
  - description: Rate generated examples or sessions and provide written feedback.
    name: Feedback
  - description: Stable exact-tree source comparison.
    name: Code Diff
  - description: >-
      Preview target resolution, cited questions and SBOM generation, plus the
      deprecated source comparison alias. Use /v1/code/diff for stable source
      comparison.
    name: Experimental
paths:
  /v1/experimental/lockfile-jobs/{id}/result:
    get:
      tags:
        - Experimental
      summary: Download a completed lockfile analysis
      description: >-
        Download the completed document in the format selected at submission.
        Only state=succeeded indicates that the result is ready. The response
        format is determined by the upstream's allowlisted media type; Accept
        does not select it. SBOM uses the same format-specific validation as
        synchronous /v1/experimental/sbom. Audit JSON receives complete syntax
        and version-aware envelope validation, preserving original evidence
        bytes. Version 2 contains compact findings, source paths, duplicate
        requirement origins and explicit coverage gaps. Opt-in version 3
        replaces legacy deprecated lists and coverage with canonical native
        lifecycle findings, attributed observations and exact paths, retained
        legacy warnings, independent coverage and unknowns. summary.lifecycle
        and summary.retained_lifecycle_warnings are not vulnerability counts.
        Unknown native checks contribute to incomplete_checks; not_collected and
        not_applicable are collection limits. Package-wide version is null, and
        source_version need not equal an affected release. Retained versions 1
        and 2 remain readable; versions 4 and newer remain opaque. Always
        dispatch on returned schema_version. Results are bounded to 16,777,216
        bytes. Pending jobs return 409 ANALYSIS_PENDING. Failed jobs return 409
        ANALYSIS_FAILED with a producer failure_code from an open vocabulary and
        a fixed safe detail; backend diagnostics are not returned. After
        authentication, malformed, missing, expired and other-owner job IDs
        produce the same 404 ANALYSIS_NOT_FOUND response; 400 remains for other
        invalid request syntax.
      operationId: lockfile_job_result
      parameters:
        - description: Hyphenated UUID returned when the job was accepted.
          in: path
          name: id
          required: true
          schema:
            format: uuid
            pattern: >-
              ^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{12}$
            type: string
        - description: >-
            Optional client attribution: trimmed printable ASCII, at most 80
            bytes. Invalid optional values are dropped.
          in: header
          name: X-GitHits-Client-Name
          required: false
          schema:
            type: string
        - description: >-
            Optional client-version attribution: trimmed printable ASCII, at
            most 80 bytes. Invalid optional values are dropped.
          in: header
          name: X-GitHits-Client-Version
          required: false
          schema:
            type: string
        - description: >-
            Optional agent attribution: trimmed printable ASCII, at most 160
            bytes. Invalid optional values are dropped.
          in: header
          name: X-GitHits-Agent
          required: false
          schema:
            type: string
        - description: >-
            Optional caller-defined session ID: one to 64 ASCII letters, digits,
            underscores or hyphens, preserved exactly. Supply the header at most
            once. Invalid supplied IDs return 400 INVALID_SESSION_ID; no session
            is created.
          in: header
          name: X-GitHits-Session-ID
          required: false
          schema:
            maxLength: 64
            minLength: 1
            pattern: ^[A-Za-z0-9_-]{1,64}$
            type: string
      responses:
        '200':
          content:
            application/json:
              example:
                coverage:
                  deprecation:
                    candidates_count: 2
                    checked_count: 1
                    not_collected_count: 0
                    not_collected_registries: []
                    unknown_count: 1
                  outdated:
                    candidates_count: 2
                    checked_count: 2
                    not_collected_count: 0
                    not_collected_registries: []
                    unknown_count: 0
                  vulnerabilities:
                    candidates_count: 2
                    checked_count: 1
                    unknown_count: 1
                    unsupported_count: 0
                    unsupported_registries: []
                findings:
                  deprecated:
                    - coordinate:
                        name: lodash
                        registry: npm
                        version: 1.0.0
                      paths:
                        - a/package-lock.json
                      reason: synthetic deprecation
                  duplicates:
                    - name: lodash
                      registry: npm
                      unattributed_requirements:
                        - path: a/package.json
                          requested_requirement: ^1.0.0
                          requester:
                            name: app-1
                            version: null
                          requirement_status: recorded
                          target_status: untargeted
                      versions:
                        - origins:
                            - path: a/package-lock.json
                              requested_requirement: ^1.0.0
                              requester:
                                name: app-1
                                version: null
                              status: recorded
                          paths:
                            - a/package-lock.json
                          version: 1.0.0
                        - origins:
                            - path: b/package-lock.json
                              requested_requirement: null
                              requester:
                                name: app-2
                                version: null
                              status: requirement_not_recorded
                          paths:
                            - b/package-lock.json
                          version: 2.0.0
                  outdated:
                    - change_type: major
                      coordinate:
                        name: lodash
                        registry: npm
                        version: 1.0.0
                      latest_version: 2.0.0
                      paths:
                        - a/package-lock.json
                  vulnerabilities:
                    - advisory_id: SYNTHETIC-1
                      aliases: []
                      coordinate:
                        name: lodash
                        registry: npm
                        version: 1.0.0
                      fixed_in_versions:
                        - 2.0.0
                      malicious: false
                      matched_ranges:
                        - <2.0.0
                      paths:
                        - a/package-lock.json
                      related_advisory_ids: []
                      severity_score: null
                      severity_type: null
                      summary: null
                      verified_remedies: []
                generated_at: '2026-10-14T00:00:00Z'
                notices:
                  - >-
                    Checks use the locally available advisory corpus and package
                    metadata; unchecked evidence stays explicit.
                  - >-
                    This is a conditional pre-build inventory, not an observed
                    installation or a constraint-conflict analysis.
                  - >-
                    File paths locate evidence. Manifest associations do not
                    establish package reachability.
                  - >-
                    Verified remedies cover all selected advisory evidence for
                    one exact coordinate, not caller constraints.
                schema_version: 2
                summary:
                  dependencies: 2
                  deprecated: 1
                  duplicates: 1
                  excluded_dependencies: 1
                  incomplete_checks: 2
                  incomplete_sources: 1
                  outdated: 1
                  vulnerabilities: 1
                unknowns:
                  excluded_dependencies:
                    - name: private-git
                      paths:
                        - a/package-lock.json
                      reason: non_registry_source
                      version: null
                  metadata:
                    - check: deprecation
                      coordinate:
                        name: lodash
                        registry: npm
                        version: 2.0.0
                      paths:
                        - b/package-lock.json
                      reason: lookup_failed
                      status: unknown
                  resolution:
                    - name: null
                      path: a/package.json
                      reason: incomplete_dependency_list
                  sources:
                    - path: a/package-lock.json
                      reasons:
                        - inventory_only
                  vulnerabilities:
                    - advisory_ids: []
                      check: vulnerabilities
                      coordinate:
                        name: lodash
                        registry: npm
                        version: 2.0.0
                      paths:
                        - b/package-lock.json
                      reasons:
                        - assessment_unavailable
                      status: unknown
              schema:
                anyOf:
                  - $ref: '#/components/schemas/AuditReport'
                  - $ref: '#/components/schemas/DependencyDiffReport'
            application/vnd.cyclonedx+json:
              example:
                bomFormat: CycloneDX
                components: []
                compositions:
                  - aggregate: incomplete
                    assemblies: []
                metadata:
                  timestamp: '2026-09-09T00:00:00Z'
                properties:
                  - name: githits:completeness
                    value: partial_manifest_inventory
                serialNumber: urn:uuid:00000000-0000-4000-8000-000000000001
                specVersion: '1.7'
                version: 1
              schema:
                $ref: '#/components/schemas/SbomCycloneDxInventory'
            text/plain:
              example: >
                GitHits dependency inventory report

                Notice: Recorded lockfile inventory, not an exact installed
                build or a compliance assertion.

                Report ID: sbom-fixture-report

                Generated: 2026-09-09T00:00:00Z

                Entries: 1

                Locked packages: 1

                Uploaded roots: 0

                Structural records: 0

                Resolved packages: 0

                Document facts:
                  completeness: "recorded_lockfile_inventory"
                Package: "dep"
                  ID: locked-dep-1.2.0
                  Known version: "1.2.0"
                  License: unknown
                  record_kind: "locked_package"
              schema:
                pattern: ^GitHits (manifest|dependency) inventory report\n
                type: string
            text/spdx:
              example: >
                SPDXVersion: SPDX-2.3

                DataLicense: CC0-1.0

                SPDXID: SPDXRef-DOCUMENT

                DocumentName: GitHits dependency inventory

                DocumentNamespace: urn:uuid:24e6d898-af42-4113-b174-7388662d8648

                Creator: Tool: GitHits

                Created: 2026-09-05T12:00:00Z

                DocumentComment:
                <text>{"completeness":"recorded_lockfile_inventory","declarations":"[]","lockfiles":"[{\"path\":\"package-lock.json\",\"format\":\"LOCKFILE_FORMAT_NPM_PACKAGE_LOCK\",\"context\":{\"categories\":[],\"requires_python\":\"\",\"resolution_markers\":[],\"provided_extras\":[],\"gradle_configurations\":[],\"supported_markers\":[],\"required_markers\":[],\"dart_sdk_constraints\":[],\"python_version\":\"\",\"bundler_platforms\":[],\"python_full_version\":\"\",\"python_targets\":[],\"nuget_targets\":[]},\"format_version\":0,\"dependency_count\":0,\"completeness\":\"LOCKFILE_COMPLETENESS_PACKAGE_ENTRIES_ONLY\",\"root_package_ids\":[1],\"format_revision\":null,\"native_format_version\":\"\",\"association_status\":\"standalone\",\"checksum_count\":0,\"manifest_lock_consistency\":\"not_checked\",\"manifest_paths\":[],\"omitted_context_counts\":{\"conflicts\":0,\"bundler_tool_checksums\":0,\"composer_platform_overrides\":0,\"conan_overrides\":0,\"conan_inventories\":0,\"composer_aliases\":0,\"conan_aliases\":0,\"poetry_checksum_sets\":0,\"dep_input_imports\":0},\"package_count\":3,\"projection_notices\":[\"relationships_not_projected\",\"integrity_not_projected\",\"resolution_context_not_projected\"],\"requirement_count\":0,\"structural_count\":1,\"structural_records\":[{\"id\":3,\"name\":\"\",\"version\":\"\",\"context\":{\"peer\":false,\"source\":{\"local_kind\":\"LOCKED_LOCAL_SOURCE_KIND_UNSPECIFIED\"},\"optional\":false,\"requires_python\":\"\",\"nuget_dependency_type\":\"NUGET_DEPENDENCY_TYPE_UNSPECIFIED\",\"bundler_platform\":\"\",\"group_conditions\":[],\"dev_optional\":false,\"extraneous\":false,\"dart_dependency_kind\":\"DART_DEPENDENCY_KIND_UNSPECIFIED\",\"berry_link_kind\":\"BERRY_LINK_KIND_UNSPECIFIED\",\"dev_only\":false,\"resolution_markers\":[],\"provided_extras\":[],\"berry_patched\":false,\"conditions\":null,\"requested_extras\":[],\"otp_application_name\":\"\"},\"role\":\"LOCKED_PACKAGE_ROLE_IMPORTER\",\"source_kind\":\"LOCKED_PACKAGE_SOURCE_KIND_REGISTRY\"}]},{\"path\":\"nested/package-lock.json\",\"format\":\"LOCKFILE_FORMAT_NPM_PACKAGE_LOCK\",\"context\":{\"categories\":[],\"requires_python\":\"\",\"resolution_markers\":[],\"provided_extras\":[],\"gradle_configurations\":[],\"supported_markers\":[],\"required_markers\":[],\"dart_sdk_constraints\":[],\"python_version\":\"\",\"bundler_platforms\":[],\"python_full_version\":\"\",\"python_targets\":[],\"nuget_targets\":[]},\"format_version\":0,\"dependency_count\":0,\"completeness\":\"LOCKFILE_COMPLETENESS_PACKAGE_ENTRIES_ONLY\",\"root_package_ids\":[1],\"format_revision\":null,\"native_format_version\":\"\",\"association_status\":\"standalone\",\"checksum_count\":0,\"manifest_lock_consistency\":\"not_checked\",\"manifest_paths\":[],\"omitted_context_counts\":{\"conflicts\":0,\"bundler_tool_checksums\":0,\"composer_platform_overrides\":0,\"conan_overrides\":0,\"conan_inventories\":0,\"composer_aliases\":0,\"conan_aliases\":0,\"poetry_checksum_sets\":0,\"dep_input_imports\":0},\"package_count\":1,\"projection_notices\":[\"relationships_not_projected\",\"integrity_not_projected\",\"resolution_context_not_projected\"],\"requirement_count\":0,\"structural_count\":0,\"structural_records\":[]}]","manifest_associations":"{}","notice":"Recorded
                conditional lockfile inventory, not an exact installed build or
                a compliance assertion. Manifest/lock consistency is not
                checked. Relationships and integrity are not projected. Licenses
                are uploaded-root or public-registry coordinate declarations,
                not source-artifact verification or legal
                conclusions.","resolution_basis":"lockfile_records","resolutions":"[]"}</text>


                PackageName: dep

                SPDXID:
                SPDXRef-locked-42925864b1614adf48873a749eb88299882ddee203e2ac218e962986df33f40d

                PackageVersion: 1.2.0

                PackageDownloadLocation: NOASSERTION

                FilesAnalyzed: false

                PackageLicenseConcluded: NOASSERTION

                PackageLicenseDeclared: MIT

                PackageLicenseComments:
                <text>{"license":"MIT","source":"registry_declared"}</text>

                PackageCopyrightText: NOASSERTION

                PackageComment:
                <text>{"context":"{\"peer\":false,\"source\":{\"local_kind\":\"LOCKED_LOCAL_SOURCE_KIND_UNSPECIFIED\"},\"optional\":false,\"requires_python\":\"\",\"nuget_dependency_type\":\"NUGET_DEPENDENCY_TYPE_UNSPECIFIED\",\"bundler_platform\":\"\",\"group_conditions\":[],\"dev_optional\":false,\"extraneous\":false,\"dart_dependency_kind\":\"DART_DEPENDENCY_KIND_UNSPECIFIED\",\"berry_link_kind\":\"BERRY_LINK_KIND_UNSPECIFIED\",\"dev_only\":false,\"resolution_markers\":[],\"provided_extras\":[],\"berry_patched\":false,\"conditions\":null,\"requested_extras\":[],\"otp_application_name\":\"\"}","license_artifact_verification":"not_checked","license_catalog_version":"3.28.0","license_expression":"MIT","license_raw":"MIT","license_source":"registry_declared","license_status":"expression","lockfile_format":"LOCKFILE_FORMAT_NPM_PACKAGE_LOCK","lockfile_path":"package-lock.json","metadata_status":"available","package_id":"1","record_kind":"locked_package","registry":"npm","resolution_basis":"lockfile_record","role":"LOCKED_PACKAGE_ROLE_PACKAGE","source_kind":"LOCKED_PACKAGE_SOURCE_KIND_REGISTRY"}</text>


                PackageName: dep

                SPDXID:
                SPDXRef-locked-4d058b03a8843e670ab6222627b94be44647ce35eb7f5e824c7760a5e9b6726d

                PackageVersion: 1.2.0

                PackageDownloadLocation: NOASSERTION

                FilesAnalyzed: false

                PackageLicenseConcluded: NOASSERTION

                PackageLicenseDeclared: MIT

                PackageLicenseComments:
                <text>{"license":"MIT","source":"registry_declared"}</text>

                PackageCopyrightText: NOASSERTION

                PackageComment:
                <text>{"context":"{\"peer\":false,\"source\":{\"local_kind\":\"LOCKED_LOCAL_SOURCE_KIND_UNSPECIFIED\"},\"optional\":false,\"requires_python\":\"\",\"nuget_dependency_type\":\"NUGET_DEPENDENCY_TYPE_UNSPECIFIED\",\"bundler_platform\":\"\",\"group_conditions\":[],\"dev_optional\":false,\"extraneous\":false,\"dart_dependency_kind\":\"DART_DEPENDENCY_KIND_UNSPECIFIED\",\"berry_link_kind\":\"BERRY_LINK_KIND_UNSPECIFIED\",\"dev_only\":false,\"resolution_markers\":[],\"provided_extras\":[],\"berry_patched\":false,\"conditions\":null,\"requested_extras\":[],\"otp_application_name\":\"\"}","license_artifact_verification":"not_checked","license_catalog_version":"3.28.0","license_expression":"MIT","license_raw":"MIT","license_source":"registry_declared","license_status":"expression","lockfile_format":"LOCKFILE_FORMAT_NPM_PACKAGE_LOCK","lockfile_path":"nested/package-lock.json","metadata_status":"available","package_id":"1","record_kind":"locked_package","registry":"npm","resolution_basis":"lockfile_record","role":"LOCKED_PACKAGE_ROLE_PACKAGE","source_kind":"LOCKED_PACKAGE_SOURCE_KIND_REGISTRY"}</text>


                PackageName: local-dep

                SPDXID:
                SPDXRef-locked-e738e69432f53950a50dcf2514b6cefda5315365b7f94e9f661196b4e8d087dc

                PackageDownloadLocation: NOASSERTION

                FilesAnalyzed: false

                PackageLicenseConcluded: NOASSERTION

                PackageLicenseDeclared: NOASSERTION

                PackageCopyrightText: NOASSERTION

                PackageComment:
                <text>{"context":"{\"peer\":false,\"source\":{\"local_kind\":\"LOCKED_LOCAL_SOURCE_KIND_UNSPECIFIED\"},\"optional\":false,\"requires_python\":\"\",\"nuget_dependency_type\":\"NUGET_DEPENDENCY_TYPE_UNSPECIFIED\",\"bundler_platform\":\"\",\"group_conditions\":[],\"dev_optional\":false,\"extraneous\":false,\"dart_dependency_kind\":\"DART_DEPENDENCY_KIND_UNSPECIFIED\",\"berry_link_kind\":\"BERRY_LINK_KIND_UNSPECIFIED\",\"dev_only\":false,\"resolution_markers\":[],\"provided_extras\":[],\"berry_patched\":false,\"conditions\":null,\"requested_extras\":[],\"otp_application_name\":\"\"}","lockfile_format":"LOCKFILE_FORMAT_NPM_PACKAGE_LOCK","lockfile_path":"package-lock.json","metadata_reason":"missing_coordinate","metadata_status":"not_eligible","package_id":"2","record_kind":"locked_package","resolution_basis":"lockfile_record","role":"LOCKED_PACKAGE_ROLE_PACKAGE","source_kind":"LOCKED_PACKAGE_SOURCE_KIND_LOCAL"}</text>


                Relationship: SPDXRef-DOCUMENT DESCRIBES
                SPDXRef-locked-42925864b1614adf48873a749eb88299882ddee203e2ac218e962986df33f40d

                Relationship: SPDXRef-DOCUMENT DESCRIBES
                SPDXRef-locked-4d058b03a8843e670ab6222627b94be44647ce35eb7f5e824c7760a5e9b6726d

                Relationship: SPDXRef-DOCUMENT DESCRIBES
                SPDXRef-locked-e738e69432f53950a50dcf2514b6cefda5315365b7f94e9f661196b4e8d087dc
              schema:
                pattern: '^SPDXVersion: SPDX-2\.3\n'
                type: string
          description: >-
            The completed UTF-8 analysis document in the format selected at
            submission. SBOM passes synchronous format validation; audit and
            dependency-diff JSON pass version-aware envelope validation. Diff
            reports preserve source-local changes, accepted-file digests,
            independent advisory/review coverage and entry-scoped changelog
            links unchanged. Response vocabularies and additive fields remain
            open; unfamiliar values must never be read as pass/safe evidence.
            The immutable document is at most 16,777,216 bytes and must not be
            cached.
          headers:
            Cache-Control:
              schema:
                enum:
                  - no-store
                type: string
            X-Request-ID:
              description: >-
                Request trace ID for diagnostics; matches problem.instance on
                failures.
              schema:
                type: string
        '400':
          content:
            application/problem+json:
              examples:
                invalid_session_id:
                  value:
                    code: INVALID_SESSION_ID
                    detail: >-
                      X-GitHits-Session-ID must occur once and match
                      [A-Za-z0-9_-]{1,64}.
                    instance: 4bf92f3577b34da6a3ce929d0e0e4736
                    status: 400
                    title: Invalid session ID
                    type: about:blank
                upstream_validation:
                  summary: Invalid request without a field-specific explanation
                  value:
                    code: VALIDATION_ERROR
                    detail: The request is invalid.
                    instance: 4bf92f3577b34da6a3ce929d0e0e4736
                    status: 400
                    title: Validation error
                    type: about:blank
                validation:
                  value:
                    code: VALIDATION_ERROR
                    detail: >-
                      query: contains unknown parameters; use only the
                      documented parameters.
                    instance: 4bf92f3577b34da6a3ce929d0e0e4736
                    status: 400
                    title: Validation error
                    type: about:blank
              schema:
                $ref: '#/components/schemas/ProblemResponse'
          description: >-
            VALIDATION_ERROR INVALID_SESSION_ID: a supplied session header is
            invalid or duplicated. VALIDATION_ERROR details identify the first
            invalid field and a reason when available. Array indices are
            zero-based; submitted values and unknown keys are not echoed.
          headers:
            Cache-Control:
              schema:
                enum:
                  - no-store
                type: string
            X-Request-ID:
              description: >-
                Request trace ID for diagnostics; matches problem.instance on
                failures.
              schema:
                type: string
        '401':
          content:
            application/problem+json:
              example:
                code: AUTHENTICATION_REQUIRED
                detail: A bearer credential is required.
                instance: 4bf92f3577b34da6a3ce929d0e0e4736
                status: 401
                title: Authentication required
                type: about:blank
              schema:
                $ref: '#/components/schemas/ProblemResponse'
          description: AUTHENTICATION_REQUIRED
          headers:
            Cache-Control:
              schema:
                enum:
                  - no-store
                type: string
            WWW-Authenticate:
              description: Bearer authentication challenge.
              schema:
                type: string
            X-Request-ID:
              description: >-
                Request trace ID for diagnostics; matches problem.instance on
                failures.
              schema:
                type: string
        '403':
          content:
            application/problem+json:
              example:
                code: FORBIDDEN
                detail: The caller is not allowed to access this resource.
                instance: 4bf92f3577b34da6a3ce929d0e0e4736
                status: 403
                title: Forbidden
                type: about:blank
              schema:
                $ref: '#/components/schemas/ProblemResponse'
          description: FORBIDDEN, ACCOUNT_INACTIVE, TERMS_ACCEPTANCE_REQUIRED
          headers:
            Cache-Control:
              schema:
                enum:
                  - no-store
                type: string
            X-Request-ID:
              description: >-
                Request trace ID for diagnostics; matches problem.instance on
                failures.
              schema:
                type: string
        '404':
          content:
            application/problem+json:
              example:
                code: ANALYSIS_NOT_FOUND
                detail: The analysis is unavailable.
                instance: 4bf92f3577b34da6a3ce929d0e0e4736
                status: 404
                title: Analysis request failed
                type: about:blank
              schema:
                $ref: '#/components/schemas/ProblemResponse'
          description: ANALYSIS_NOT_FOUND
          headers:
            Cache-Control:
              schema:
                enum:
                  - no-store
                type: string
            X-Request-ID:
              description: >-
                Request trace ID for diagnostics; matches problem.instance on
                failures.
              schema:
                type: string
        '405':
          content:
            application/problem+json:
              example:
                code: METHOD_NOT_ALLOWED
                detail: The requested method is not supported for this route.
                instance: 4bf92f3577b34da6a3ce929d0e0e4736
                status: 405
                title: Method not allowed
                type: about:blank
              schema:
                $ref: '#/components/schemas/ProblemResponse'
          description: 'METHOD_NOT_ALLOWED: the route does not support this HTTP method.'
          headers:
            Allow:
              description: 'Supported methods: GET, HEAD.'
              schema:
                type: string
            Cache-Control:
              schema:
                enum:
                  - no-store
                type: string
            X-Request-ID:
              description: >-
                Request trace ID for diagnostics; matches problem.instance on
                failures.
              schema:
                type: string
        '409':
          content:
            application/problem+json:
              example:
                code: ANALYSIS_PENDING
                detail: The analysis has not finished.
                instance: 4bf92f3577b34da6a3ce929d0e0e4736
                status: 409
                title: Analysis request failed
                type: about:blank
              schema:
                oneOf:
                  - allOf:
                      - $ref: '#/components/schemas/ProblemResponse'
                      - properties:
                          code:
                            enum:
                              - ANALYSIS_PENDING
                            type: string
                          detail:
                            enum:
                              - The analysis has not finished.
                            type: string
                          title:
                            enum:
                              - Analysis request failed
                            type: string
                        required:
                          - code
                          - title
                          - detail
                        type: object
                  - allOf:
                      - $ref: '#/components/schemas/ProblemResponse'
                      - properties:
                          code:
                            enum:
                              - ANALYSIS_FAILED
                            type: string
                          detail:
                            enum:
                              - The analysis failed.
                            type: string
                          failure_code:
                            description: >-
                              Failure code from the analysis; new codes can
                              appear. Internal diagnostics are not included.
                            type: string
                          title:
                            enum:
                              - Analysis request failed
                            type: string
                        required:
                          - code
                          - title
                          - detail
                          - failure_code
                        type: object
          description: ANALYSIS_PENDING, ANALYSIS_FAILED
          headers:
            Cache-Control:
              schema:
                enum:
                  - no-store
                type: string
            X-Request-ID:
              description: >-
                Request trace ID for diagnostics; matches problem.instance on
                failures.
              schema:
                type: string
        '429':
          content:
            application/problem+json:
              example:
                code: RATE_LIMITED
                detail: The request was rate limited.
                instance: 4bf92f3577b34da6a3ce929d0e0e4736
                status: 429
                title: Rate limited
                type: about:blank
              schema:
                $ref: '#/components/schemas/ProblemResponse'
          description: >-
            RATE_LIMITED


            QUOTA_EXCEEDED means a usage allowance is exhausted. When supplied,
            pool identifies the allowance (analysis for monthly analysis or
            requests for daily requests), limit gives its size, and resets_at
            gives its RFC 3339 reset time. When Retry-After is supplied, wait
            until that delay or HTTP date before trying again.
          headers:
            Cache-Control:
              schema:
                enum:
                  - no-store
                type: string
            Retry-After:
              description: Validated delay or HTTP-date for quota reset, when available.
              schema:
                type: string
            X-Request-ID:
              description: >-
                Request trace ID for diagnostics; matches problem.instance on
                failures.
              schema:
                type: string
        '500':
          description: >-
            A request ID could not be assigned. The response has an empty body
            and no X-Request-ID or problem object; try again later.
          headers:
            Cache-Control:
              schema:
                enum:
                  - no-store
                type: string
          x-githits-empty-identity-failure: true
        '502':
          content:
            application/problem+json:
              example:
                code: UPSTREAM_ERROR
                detail: The upstream service failed to provide a response.
                instance: 4bf92f3577b34da6a3ce929d0e0e4736
                status: 502
                title: Upstream error
                type: about:blank
              schema:
                $ref: '#/components/schemas/ProblemResponse'
          description: UPSTREAM_ERROR
          headers:
            Cache-Control:
              schema:
                enum:
                  - no-store
                type: string
            X-Request-ID:
              description: >-
                Request trace ID for diagnostics; matches problem.instance on
                failures.
              schema:
                type: string
        '503':
          content:
            application/problem+json:
              example:
                code: ANALYSIS_UNAVAILABLE
                detail: Analysis is temporarily unavailable.
                instance: 4bf92f3577b34da6a3ce929d0e0e4736
                status: 503
                title: Analysis request failed
                type: about:blank
              schema:
                $ref: '#/components/schemas/ProblemResponse'
          description: >-
            ANALYSIS_UNAVAILABLE, UPSTREAM_UNAVAILABLE QUOTA_UNAVAILABLE: your
            daily allowance could not be checked. This is temporary; retry the
            same request later (retryable=true).
          headers:
            Cache-Control:
              schema:
                enum:
                  - no-store
                type: string
            X-Request-ID:
              description: >-
                Request trace ID for diagnostics; matches problem.instance on
                failures.
              schema:
                type: string
        '504':
          content:
            application/problem+json:
              example:
                code: TIMEOUT
                detail: The upstream request did not complete in time.
                instance: 4bf92f3577b34da6a3ce929d0e0e4736
                status: 504
                title: Upstream timeout
                type: about:blank
              schema:
                $ref: '#/components/schemas/ProblemResponse'
          description: TIMEOUT
          headers:
            Cache-Control:
              schema:
                enum:
                  - no-store
                type: string
            X-Request-ID:
              description: >-
                Request trace ID for diagnostics; matches problem.instance on
                failures.
              schema:
                type: string
      security:
        - bearer_auth: []
components:
  schemas:
    AuditReport:
      description: >-
        Audit response dispatched by returned schema_version: retained v1,
        default v2, opt-in native lifecycle v3, and opaque future versions.
        Requested version is not a guarantee of returned version.
      oneOf:
        - $ref: '#/components/schemas/AuditReportV1'
        - $ref: '#/components/schemas/AuditReportFuture'
        - $ref: '#/components/schemas/AuditReportV2'
        - $ref: '#/components/schemas/AuditReportV3'
    DependencyDiffReport:
      description: >-
        Dependency diff Report contract; response evidence remains
        producer-owned.
      oneOf:
        - $ref: '#/components/schemas/DependencyDiffReportV1'
        - $ref: '#/components/schemas/DependencyDiffReportFuture'
    SbomCycloneDxInventory:
      additionalProperties: true
      description: >-
        Extensible CycloneDX 1.7 document. This schema describes a compatible
        subset, not the entire standard. Additional fields are allowed at every
        object level; clients must preserve or ignore unfamiliar data. Inventory
        and license completeness must be read from evidence, not inferred from
        this schema.
      properties:
        bomFormat:
          enum:
            - CycloneDX
          type: string
        components:
          description: >-
            Named project roots and dependency entries. Unresolved declarations
            remain in document properties rather than becoming package
            components. The array may be empty when no concrete packages or
            named roots are available. Separate lockfile occurrences may have
            the same name and version; do not deduplicate by those fields alone.
          items:
            $ref: '#/components/schemas/SbomComponent'
          type: array
        compositions:
          description: Completeness declaration for the listed component references.
          items:
            additionalProperties: true
            properties:
              aggregate:
                description: >-
                  Reported completeness of the referenced inventory. Do not
                  infer that additional fields establish completeness.
                type: string
              assemblies:
                description: >-
                  References to entries in components, using each entry's
                  bom-ref.
                items:
                  type: string
                type: array
            required:
              - aggregate
            type: object
          type: array
        dependencies:
          description: >-
            Reported dependency relationships using opaque bom-ref references.
            Missing connectivity does not by itself mean a component has no
            dependencies; read the coverage declarations as well.
          items:
            additionalProperties: true
            type: object
          type: array
        metadata:
          additionalProperties: true
          properties:
            component:
              $ref: '#/components/schemas/SbomComponent'
              description: >-
                Selected primary project or source entry, when one can be
                selected. That same entry is not repeated in the top-level
                components array.
            timestamp:
              description: Time this document was generated.
              format: date-time
              type: string
          type: object
        properties:
          description: >-
            Document evidence. githits:completeness distinguishes
            resolved_manifest_inventory, partial_manifest_inventory,
            recorded_lockfile_inventory and mixed_dependency_inventory; none
            guarantees that every license is known. githits:resolution_basis
            distinguishes manifest_resolution, lockfile_records and
            lockfile_records_and_manifest_resolution. Inspect
            githits:resolutions for per-manifest outcomes, githits:declarations
            for original requirements, and githits:lockfiles and
            githits:manifest_associations for lockfile coverage. githits:notice
            summarizes limitations.
          items:
            $ref: '#/components/schemas/SbomProperty'
          type: array
        serialNumber:
          description: >-
            Unique identifier for this generated document. This URN is not a
            retrieval URL.
          pattern: >-
            ^urn:uuid:[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
          type: string
        specVersion:
          description: >-
            CycloneDX specification version. Accept unfamiliar versions and
            additional fields.
          type: string
        version:
          description: Document revision, not a package version.
          minimum: 1
          type: integer
      required:
        - bomFormat
        - specVersion
      type: object
    ProblemResponse:
      description: >-
        The stable problem document returned for an unsuccessful public API
        request.
      properties:
        acceptance_url:
          description: Link for accepting the required terms, when provided.
          type: string
        code:
          description: The stable uppercase API error code.
          type: string
        detail:
          description: >-
            Human-readable explanation. Wording can change; use code and
            structured fields for program logic. Validation errors identify the
            first invalid field (including zero-based array indices) and a
            reason; version errors can include canonical-version guidance.
          type: string
        instance:
          description: >-
            Request ID matching the X-Request-ID response header; include it
            when seeking support.
          type: string
        limit:
          description: >-
            Allowance in the exhausted pool's units for `QUOTA_EXCEEDED` when
            supplied.
          format: int64
          minimum: 0
          type: integer
        pool:
          description: >-
            Exhausted allowance pool for `QUOTA_EXCEEDED` when supplied. Known
            values include `analysis` and `requests`. Clients must accept new
            values.
          type: string
        resets_at:
          description: >-
            Time when the exhausted allowance resets for `QUOTA_EXCEEDED` when
            supplied.
          format: date-time
          type: string
        retryable:
          description: >-
            Whether retrying later may help, when supplied. Follow this flag for
            lookup/provider outcomes and temporary daily-allowance failures;
            malformed evidence can be nonretryable.
          type: boolean
        status:
          description: The HTTP status returned with this problem.
          format: int32
          minimum: 0
          type: integer
        terms_url:
          description: Link to the terms that require acceptance, when provided.
          type: string
        title:
          description: A short, stable title for the error.
          type: string
        type:
          description: The generic RFC 9457 problem type.
          type: string
      required:
        - type
        - title
        - status
        - detail
        - instance
        - code
      type: object
    AuditReportV1:
      additionalProperties: true
      description: >-
        Versioned dependency audit report. It describes a conditional pre-build
        inventory, not an observed installation, constraint conflict analysis or
        globally fresh safety result.
      properties:
        coverage:
          $ref: '#/components/schemas/AuditCoverage'
          description: >-
            Independent advisory, metadata, duplicate and source completeness
            evidence.
        findings:
          $ref: '#/components/schemas/AuditFindings'
          description: >-
            Confirmed vulnerability, deprecation, outdated and duplicate
            findings with occurrence attribution.
        generated_at:
          description: UTC time when report assembly occurred.
          format: date-time
          type: string
        inputs:
          $ref: '#/components/schemas/AuditInputs'
          description: >-
            Manifest, declaration, subject, association and parsing evidence
            from the uploaded files.
        notices:
          description: >-
            Producer notices about source scope, freshness and remedy
            applicability. Text and count may evolve.
          items:
            type: string
          type: array
        occurrences:
          description: >-
            Original dependency records and manifest-derived resolutions,
            including excluded sources.
          items:
            $ref: '#/components/schemas/AuditOccurrence'
          type: array
        report_id:
          description: >-
            The stable source inventory UUID; the job ID remains the retrieval
            pointer.
          format: uuid
          type: string
        schema_version:
          description: Version 1 uses the documented audit structure.
          enum:
            - 1
          type: integer
        summary:
          $ref: '#/components/schemas/AuditSummary'
          description: >-
            Counts for this combined upload; findings, evidence gaps and source
            coverage use separate denominators.
        unknowns:
          $ref: '#/components/schemas/AuditUnknowns'
          description: >-
            Incomplete checks, source gaps and excluded occurrences retained
            alongside findings.
      required:
        - schema_version
        - report_id
        - generated_at
        - summary
        - inputs
        - occurrences
        - coverage
        - findings
        - unknowns
        - notices
      type: object
    AuditReportFuture:
      additionalProperties: true
      description: >-
        An opaque audit version 4 or newer. Preserve the document and accept
        unfamiliar evidence; never infer a safe result from unfamiliar fields.
      properties:
        schema_version:
          description: A report version this gateway does not interpret.
          minimum: 4
          type: integer
      required:
        - schema_version
      type: object
    AuditReportV2:
      additionalProperties: true
      description: >-
        Compact actionable audit. Includes findings, affected input paths,
        useful duplicate requirement origins and meaningful unchecked evidence.
        The base does not export input/occurrence inventories, native IDs,
        graphs or parser statistics. This is pre-build evidence, not
        solver-conflict analysis or a globally fresh safety result.
      properties:
        coverage:
          $ref: '#/components/schemas/AuditCoverageV2'
          description: Independent advisory and metadata check coverage.
        findings:
          $ref: '#/components/schemas/AuditFindingsV2'
          description: Actionable findings grouped by category.
        generated_at:
          description: Timestamp when this immutable report was generated.
          format: date-time
          type: string
        notices:
          description: Interpretation limits supplied by the report producer.
          items:
            description: >-
              Producer interpretation notices; text and count may evolve.
              Clients must accept unfamiliar values.
            type: string
          type: array
        remediation:
          $ref: '#/components/schemas/AuditRemediationV2'
          description: >-
            Optional remediation evidence, including recommendations and any
            retained occurrence/relation trace. Older reports may omit it.
        schema_version:
          description: >-
            Compact report version 2; inspect schema_version before interpreting
            fields.
          enum:
            - 2
          type: integer
        summary:
          $ref: '#/components/schemas/AuditSummaryV2'
          description: Counts of findings and incomplete evidence in the combined analysis.
        unknowns:
          $ref: '#/components/schemas/AuditUnknownsV2'
          description: >-
            Distinct advisory, metadata, source, resolution and eligibility
            gaps.
      required:
        - schema_version
        - generated_at
        - summary
        - findings
        - coverage
        - unknowns
        - notices
      type: object
    AuditReportV3:
      additionalProperties: true
      description: >-
        Opt-in native lifecycle contract. Request report_version=3 for audit
        jobs. Default submissions remain v2. Clients dispatch on returned
        schema_version, including during rolling deploy/rollback. Retained
        immutable v1/v2 bytes are unchanged. Legacy deprecated lists and
        coverage are replaced by lifecycle; vulnerability, outdated, selection
        and remediation meanings remain unchanged.
      properties:
        coverage:
          $ref: '#/components/schemas/AuditCoverageV3'
          description: Independent advisory and metadata check coverage.
        findings:
          $ref: '#/components/schemas/AuditFindingsV3'
          description: Actionable findings grouped by category.
        generated_at:
          description: Timestamp when this immutable report was generated.
          format: date-time
          type: string
        lifecycle:
          $ref: '#/components/schemas/AuditLifecycle'
          description: >-
            Canonical native lifecycle evidence, independent of advisory,
            selection and remediation policy.
        notices:
          description: Interpretation limits supplied by the report producer.
          items:
            description: >-
              Producer interpretation notices; text and count may evolve.
              Clients must accept unfamiliar values.
            type: string
          type: array
        remediation:
          $ref: '#/components/schemas/AuditRemediationV2'
          description: >-
            Optional remediation evidence, including recommendations and any
            retained occurrence/relation trace. Older reports may omit it.
        schema_version:
          description: >-
            Native lifecycle audit version 3. Always inspect the returned
            version; older workers may return v2 even when v3 was requested.
          enum:
            - 3
          type: integer
        summary:
          $ref: '#/components/schemas/AuditSummaryV3'
          description: Counts of findings and incomplete evidence in the combined analysis.
        unknowns:
          $ref: '#/components/schemas/AuditUnknownsV3'
          description: >-
            Distinct advisory, metadata, source, resolution and eligibility
            gaps.
      required:
        - schema_version
        - generated_at
        - summary
        - findings
        - coverage
        - unknowns
        - notices
        - lifecycle
      type: object
    DependencyDiffReportV1:
      description: >-
        Selected-input-only source-local comparison using current shared
        evidence. Recorded ownership is separate from effective ownership.
        Counts measure occurrences, source/package contexts, canonical
        coordinates or deduplicated review tuples as named; they are not
        interchangeable package counts. Response objects and vocabularies are
        open to additive evolution.
      properties:
        accepted_request:
          $ref: '#/components/schemas/DependencyDiffAcceptedRequest'
          description: >-
            Producer-accepted controls; additive response fields and values
            remain open.
        advisories:
          $ref: '#/components/schemas/DependencyDiffSection'
          description: Current advisory assessments and independently qualified deltas.
        changes:
          description: Source/unit/package occurrence-multiset transitions.
          items:
            $ref: '#/components/schemas/DependencyDiffChange'
          type: array
        coverage:
          description: Independent coverage and reasons for missing evidence.
          type: object
        declaration_changes:
          description: >-
            Declaration and binding transitions, independent of occurrence
            changes.
          items:
            $ref: '#/components/schemas/DependencyDiffDeclarationChange'
          type: array
        direct_reviews:
          $ref: '#/components/schemas/DependencyDiffReviewSection'
          description: >-
            Exact eligible direct-version reviews and independent completion
            coverage.
        generated_at:
          description: Time of this comparison using current shared evidence.
          format: date-time
          type: string
        kind:
          description: Open response vocabulary; currently diff.
          type: string
        notices:
          description: >-
            Producer qualifications relevant to interpreting the selected-input
            report.
          items:
            type: string
          type: array
        outcome:
          description: ' Open response vocabulary; known values: complete, partial. Unfamiliar values retain producer meaning; do not infer pass/safe.'
          type: string
        schema_version:
          description: Version of this dependency comparison envelope.
          maximum: 1
          minimum: 1
          type: integer
        snapshots:
          description: >-
            Base/head snapshots retaining source-local evidence and side-local
            identities.
          properties:
            base:
              $ref: '#/components/schemas/DependencyDiffSnapshot'
              description: Base selected input snapshot.
            head:
              $ref: '#/components/schemas/DependencyDiffSnapshot'
              description: Head selected input snapshot.
          required:
            - base
            - head
          type: object
        summary:
          description: >-
            Producer counts scoped as named; occurrence, coordinate and review
            counts are not interchangeable.
          type: object
      required:
        - schema_version
        - kind
        - accepted_request
        - generated_at
        - outcome
        - snapshots
        - changes
        - declaration_changes
        - advisories
        - direct_reviews
        - coverage
        - summary
        - notices
      type: object
    DependencyDiffReportFuture:
      description: >-
        Future diff schemas may restructure evidence. Preserve unknown versions
        and do not infer pass/safe.
      properties:
        kind:
          description: Producer evidence kind; response vocabulary is open.
          type: string
        schema_version:
          description: Version of this dependency comparison envelope.
          minimum: 2
          type: integer
      required:
        - schema_version
        - kind
      type: object
    SbomComponent:
      additionalProperties: true
      description: >-
        An uploaded project root, a resolved dependency or a recorded lockfile
        package. Use githits:record_kind in properties to distinguish them.
      properties:
        bom-ref:
          description: >-
            Opaque component identifier used by references within this document.
            It is not a package URL or an artifact checksum.
          type: string
        evidence:
          additionalProperties: true
          description: >-
            Observed evidence, separate from the component licenses choices.
            Source-file detections are observations rather than publisher
            declarations.
          properties:
            licenses:
              description: >-
                Observed license objects, including source-file detections. For
                file paths and detection status, parse the JSON string in the
                component property named githits:source_license_evidence when
                present.
              items:
                additionalProperties: true
                type: object
              type: array
          type: object
        externalReferences:
          description: >-
            Declared source-repository or distribution references. Hashes within
            a reference describe that referenced resource and remain separate
            from component hashes; a URL does not certify an installed artifact.
          items:
            additionalProperties: true
            type: object
          type: array
        hashes:
          description: >-
            Checksums recorded for this component or file. They are not
            recalculated for your installed copy and do not include hashes owned
            by externalReferences.
          items:
            additionalProperties: true
            type: object
          type: array
        licenses:
          description: >-
            Standard license choices: SPDX expressions or licenses identified by
            id or name, with optional acknowledgement and additional standard
            evidence. Preserve the original evidence; no license conclusion is
            inferred.
          items:
            oneOf:
              - additionalProperties: true
                properties:
                  license:
                    additionalProperties: true
                    properties:
                      id:
                        description: SPDX license identifier.
                        type: string
                      name:
                        description: >-
                          License name, including free-text and proprietary
                          names.
                        type: string
                    type: object
                required:
                  - license
                type: object
              - additionalProperties: true
                properties:
                  acknowledgement:
                    description: >-
                      Standard license acknowledgement, such as declared or
                      concluded; preserve the reported value.
                    type: string
                  expression:
                    description: >-
                      Recognized SPDX license expression, including a single
                      identifier such as MIT or a compound expression such as
                      MIT OR Apache-2.0. This is a declaration, not a legal
                      conclusion or artifact verification.
                    type: string
                required:
                  - expression
                type: object
          type: array
        name:
          description: >-
            Package or project name. Names are not unique across registries,
            versions or lockfile occurrences.
          type: string
        properties:
          description: >-
            Additional input, identity and license facts as name/value pairs.
            Match by name rather than position; a property can repeat or have no
            value. Plain paths and statuses remain strings. Parse JSON only for
            the known structured properties you use.


            githits:record_kind distinguishes uploaded manifests, resolved
            packages and lockfile occurrences. githits:resolution_basis explains
            how a dependency was selected.
            githits:purl_basis=manifest_resolution identifies a package URL
            based on manifest resolution; githits:purl_omission_reason can
            explain an absent package URL (for example missing_identity_facets,
            unsupported_registry or invalid_coordinate). githits:metadata_status
            describes metadata availability. These are not license-verification
            results; githits:license_artifact_verification=not_checked means the
            specific source artifact or commit was not checked.


            githits:publisher_license_evidence contains a JSON object encoded
            inside its value string. Parse it to read original publisher
            statements, their release/package/repository scope,
            source/field/version, relationships and interpretation issues.
            githits:source_license_evidence separately contains a JSON object
            with the detection service/method, module/version, observation
            status/time, per-file paths/detected_licenses (including nested
            files), and last-attempt status/time. Missing evidence does not mean
            no license exists. These properties preserve context; do not combine
            independent observations into a license conclusion. Additional
            names, statuses and fields can appear.
          items:
            $ref: '#/components/schemas/SbomProperty'
          type: array
        purl:
          description: >-
            Identifies a concrete package selected by manifest dependency
            resolution. Present for supported registry coordinates even when
            license metadata is unavailable. Omitted for uploaded roots,
            unresolved declarations and lockfile occurrences, and when required
            identity details are unavailable. Presence does not verify installed
            or artifact contents; it is not a download URL. Preserve bom-ref for
            document relationships and occurrences.
          examples:
            - pkg:npm/%40scope/dep@1.2.3
          minLength: 1
          pattern: '^pkg:'
          type: string
        scope:
          description: >-
            Reported standard component scope, for example excluded. An absent
            scope is not evidence that only runtime dependencies were selected.
          type: string
        type:
          description: >-
            CycloneDX component classification, such as library, application or
            container. Clients must allow new standard classifications.
          type: string
        version:
          description: >-
            Version declared by an uploaded project, selected during dependency
            resolution, or recorded in a lockfile. Omitted when unknown;
            omission does not mean the latest version.
          type: string
      required:
        - type
        - name
      type: object
    SbomProperty:
      additionalProperties: true
      description: >-
        Extensible standard property. Match by name rather than array position;
        ignore names your client does not recognize.
      examples:
        - name: githits:record_kind
          value: resolved_package
        - name: githits:manifest_paths
          value: '["app/package.json"]'
      properties:
        name:
          description: >-
            Property name. GitHits evidence uses the githits: namespace; other
            namespaces are also allowed.
          type: string
        value:
          description: >-
            Optional evidence value, encoded as a string when present.
            Structured values such as githits:declarations, githits:resolutions,
            githits:lockfiles, githits:manifest_associations,
            githits:manifest_paths and githits:lockfile_paths contain JSON;
            parse those separately when needed. Do not JSON-parse every
            property: paths and statuses can be plain strings.
          type: string
      required:
        - name
      type: object
    AuditCoverage:
      additionalProperties: true
      description: >-
        Independent coverage partitions for advisory checks, metadata checks,
        duplicate candidates and source resolution.
      properties:
        deprecation:
          $ref: '#/components/schemas/AuditMetadataCoverage'
          description: Coverage of the deprecation metadata check by distinct coordinate.
        duplicates:
          $ref: '#/components/schemas/AuditDuplicateCoverage'
          description: >-
            Eligible coordinate and excluded occurrence coverage for duplicate
            grouping.
        outdated:
          $ref: '#/components/schemas/AuditMetadataCoverage'
          description: >-
            Coverage of the latest-version metadata check by distinct
            coordinate.
        sources:
          description: >-
            Outgoing dependency evidence coverage for each occurrence, manifest
            or structural subject owner.
          items:
            $ref: '#/components/schemas/AuditSourceCoverage'
          type: array
        vulnerabilities:
          $ref: '#/components/schemas/AuditVulnerabilityCoverage'
          description: >-
            Advisory assessment coverage by distinct coordinate, independent of
            confirmed findings.
      required:
        - vulnerabilities
        - deprecation
        - outdated
        - duplicates
        - sources
      type: object
    AuditFindings:
      additionalProperties: true
      properties:
        deprecated:
          description: Coordinates whose registry metadata reports deprecation.
          items:
            $ref: '#/components/schemas/AuditDeprecatedFinding'
          type: array
        duplicates:
          description: >-
            Registry/name groups with multiple distinct eligible versions across
            the combined upload.
          items:
            $ref: '#/components/schemas/AuditDuplicateFinding'
          type: array
        outdated:
          description: Coordinates behind the metadata source latest version.
          items:
            $ref: '#/components/schemas/AuditOutdatedFinding'
          type: array
        vulnerabilities:
          description: >-
            Confirmed affected coordinate/advisory findings with input
            attribution.
          items:
            $ref: '#/components/schemas/AuditVulnerabilityFinding'
          type: array
      required:
        - vulnerabilities
        - deprecated
        - outdated
        - duplicates
      type: object
    AuditInputs:
      additionalProperties: true
      description: >-
        Selected parsed evidence only. Declarations exclude raw requirements and
        source URLs; lockfiles exclude raw bodies and source locators.
      properties:
        declarations:
          description: >-
            Manifest dependency declarations with recorded scope and
            optionality, separate from resolved occurrences.
          items:
            $ref: '#/components/schemas/AuditDeclarationInput'
          type: array
        lockfiles:
          description: Per-lockfile parsing, association and projection summaries.
          items:
            $ref: '#/components/schemas/AuditLockfileInput'
          type: array
        manifest_associations:
          additionalProperties:
            items:
              type: string
            type: array
          description: >-
            Manifest file path to associated lockfile paths. Join a
            lockfile-record occurrence's lockfile_path against these values to
            find its file associations; this does not claim package reachability
            or directness.
          type: object
        manifests:
          description: Uploaded manifest roots retained as source evidence.
          items:
            $ref: '#/components/schemas/AuditManifestInput'
          type: array
        resolutions:
          description: >-
            Per-manifest resolution outcomes and incomplete-resolution
            diagnostics.
          items:
            $ref: '#/components/schemas/AuditManifestResolution'
          type: array
        subjects:
          description: >-
            Input evidence for structural lockfile subjects; these records are
            not vulnerability-assessed occurrences or dependency counts.
          items:
            $ref: '#/components/schemas/AuditSubjectInput'
          type: array
      required:
        - manifests
        - subjects
        - declarations
        - resolutions
        - manifest_associations
        - lockfiles
      type: object
    AuditOccurrence:
      additionalProperties: true
      description: >-
        One retained source occurrence. A missing coordinate stays explicit and
        never borrows findings from a name collision.
      properties:
        basis:
          description: >-
            How this occurrence was obtained, such as lockfile_record or
            manifest_resolution. Open response vocabulary; clients must accept
            unfamiliar values.
          type: string
        coordinate:
          description: >-
            Eligible registry/name/version assessment identity; null for an
            excluded source occurrence.
          oneOf:
            - $ref: '#/components/schemas/AuditCoordinate'
            - type: 'null'
        eligibility_reason:
          description: A bounded reason when no eligible public registry coordinate exists.
          type:
            - string
            - 'null'
        id:
          description: >-
            Occurrence identifier referenced by finding occurrence_ids and
            excluded occurrence_id fields.
          type: string
        lockfile_path:
          description: >-
            Recorded lockfile path; join it to inputs.manifest_associations to
            find file-level manifest associations. This does not establish
            package reachability or directness.
          type:
            - string
            - 'null'
        name:
          description: Dependency name recorded for this occurrence.
          type: string
        native_package_id:
          description: >-
            Original package identifier within the lockfile; null for a
            manifest-derived occurrence.
          type:
            - string
            - 'null'
        resolution_manifest_paths:
          description: >-
            The manifest paths whose resolver produced this manifest-derived
            occurrence.
          items:
            type: string
          type: array
        version:
          description: Recorded or resolved dependency version; null when unavailable.
          type:
            - string
            - 'null'
      required:
        - id
        - name
        - version
        - coordinate
        - basis
        - lockfile_path
        - native_package_id
        - resolution_manifest_paths
        - eligibility_reason
      type: object
    AuditSummary:
      additionalProperties: true
      description: >-
        Counts of distinct eligible coordinates, source occurrences, finding
        categories, excluded occurrences and incomplete evidence. No count
        implies globally complete or safe coverage.
      properties:
        dependencies:
          description: >-
            Number of distinct non-null registry/name/version coordinates across
            occurrences.
          minimum: 0
          type: integer
        deprecated:
          description: Number of coordinate findings in findings.deprecated.
          minimum: 0
          type: integer
        duplicates:
          description: >-
            Number of registry/name groups in findings.duplicates with multiple
            distinct versions.
          minimum: 0
          type: integer
        excluded_occurrences:
          description: >-
            Number of unknowns.excluded_occurrences entries with no eligible
            registry coordinate.
          minimum: 0
          type: integer
        incomplete_checks:
          description: >-
            Sum of coverage.vulnerabilities.unknown_count,
            coverage.vulnerabilities.unsupported_count and the length of
            unknowns.metadata.
          minimum: 0
          type: integer
        incomplete_sources:
          description: >-
            Number of unknowns.sources entries whose source coverage is not
            complete.
          minimum: 0
          type: integer
        occurrences:
          description: Number of entries in occurrences, including excluded source records.
          minimum: 0
          type: integer
        outdated:
          description: Number of coordinate findings in findings.outdated.
          minimum: 0
          type: integer
        vulnerabilities:
          description: >-
            Number of coordinate/advisory findings in findings.vulnerabilities,
            not unique advisory IDs.
          minimum: 0
          type: integer
      required:
        - dependencies
        - occurrences
        - vulnerabilities
        - deprecated
        - outdated
        - duplicates
        - excluded_occurrences
        - incomplete_sources
        - incomplete_checks
      type: object
    AuditUnknowns:
      additionalProperties: true
      description: >-
        Per-coordinate, per-check and per-source unknown evidence. Missing
        evidence is not emitted as a clean result.
      properties:
        excluded_occurrences:
          description: >-
            Occurrences with no eligible public registry coordinate; preserve
            their input attribution and exclusion reason.
          items:
            additionalProperties: true
            properties:
              occurrence_id:
                description: >-
                  Identifier in occurrences[].id of the source record excluded
                  from registry-coordinate assessment.
                type: string
              reason:
                description: >-
                  Producer reason this occurrence has no eligible public
                  registry coordinate. Open response vocabulary; clients must
                  accept unfamiliar values.
                type: string
            required:
              - occurrence_id
              - reason
            type: object
          type: array
        metadata:
          description: >-
            Unevaluated per-coordinate metadata checks, counted independently
            for each check family.
          items:
            $ref: '#/components/schemas/AuditMetadataUnknown'
          type: array
        sources:
          description: Source coverage entries whose state is not complete.
          items:
            $ref: '#/components/schemas/AuditSourceCoverage'
          type: array
        vulnerabilities:
          description: >-
            Coordinates with unknown, unsupported or qualified advisory
            assessment evidence; these may coexist with confirmed findings.
          items:
            $ref: '#/components/schemas/AuditVulnerabilityUnknown'
          type: array
      required:
        - vulnerabilities
        - metadata
        - sources
        - excluded_occurrences
      type: object
    AuditCoverageV2:
      additionalProperties: true
      description: >-
        Independent check coverage over eligible exact coordinates. Empty
        findings do not establish complete or globally fresh checks.
      properties:
        deprecation:
          $ref: '#/components/schemas/AuditMetadataCoverage'
          description: Coverage of the deprecation metadata check by distinct coordinate.
        outdated:
          $ref: '#/components/schemas/AuditMetadataCoverage'
          description: >-
            Coverage of the latest-version metadata check by distinct
            coordinate.
        vulnerabilities:
          $ref: '#/components/schemas/AuditVulnerabilityCoverage'
          description: >-
            Advisory assessment coverage by distinct coordinate, independent of
            confirmed findings.
      required:
        - vulnerabilities
        - deprecation
        - outdated
      type: object
    AuditFindingsV2:
      additionalProperties: true
      properties:
        deprecated:
          description: Coordinates whose registry metadata reports deprecation.
          items:
            $ref: '#/components/schemas/AuditDeprecatedFindingV2'
          type: array
        duplicates:
          description: >-
            Registry/name groups with multiple distinct eligible versions across
            the combined upload.
          items:
            $ref: '#/components/schemas/AuditDuplicateFindingV2'
          type: array
        outdated:
          description: Coordinates behind the metadata source latest version.
          items:
            $ref: '#/components/schemas/AuditOutdatedFindingV2'
          type: array
        vulnerabilities:
          description: >-
            Confirmed affected coordinate/advisory findings with input
            attribution.
          items:
            $ref: '#/components/schemas/AuditVulnerabilityFindingV2'
          type: array
      required:
        - vulnerabilities
        - deprecated
        - outdated
        - duplicates
      type: object
    AuditRemediationV2:
      additionalProperties: true
      description: >-
        Producer remediation result with conditional recommendations,
        independently retained trace and output-omission accounting.
      properties:
        limits:
          $ref: '#/components/schemas/AuditRemediationLimits'
          description: >-
            Producer output-omission accounting, including search entries from
            omitted recommendations and losing alternatives.
        recommendations:
          description: >-
            Conditional remediation recommendations supplied by the report
            producer.
          items:
            $ref: '#/components/schemas/AuditRemediationRecommendation'
          type: array
        trace:
          $ref: '#/components/schemas/AuditRemediationTrace'
          description: >-
            Producer occurrence/relation trace, retained independently from
            whole-search search_details.
      type: object
    AuditSummaryV2:
      additionalProperties: true
      properties:
        dependencies:
          description: >-
            Distinct eligible registry/name/version coordinates, independent of
            metadata availability.
          minimum: 0
          type: integer
        deprecated:
          description: Number of coordinate findings in findings.deprecated.
          minimum: 0
          type: integer
        duplicates:
          description: >-
            Number of registry/name groups in findings.duplicates with multiple
            distinct versions.
          minimum: 0
          type: integer
        excluded_dependencies:
          description: >-
            Distinct source-excluded name/version/reason groups; not counted as
            eligible dependencies.
          minimum: 0
          type: integer
        incomplete_checks:
          description: >-
            Sum of coverage.vulnerabilities.unknown_count,
            coverage.vulnerabilities.unsupported_count and the length of
            unknowns.metadata.
          minimum: 0
          type: integer
        incomplete_sources:
          description: Distinct input files with outgoing-dependency coverage gaps.
          minimum: 0
          type: integer
        outdated:
          description: Number of coordinate findings in findings.outdated.
          minimum: 0
          type: integer
        vulnerabilities:
          description: >-
            Number of coordinate/advisory findings in findings.vulnerabilities,
            not unique advisory IDs.
          minimum: 0
          type: integer
      required:
        - dependencies
        - vulnerabilities
        - deprecated
        - outdated
        - duplicates
        - excluded_dependencies
        - incomplete_sources
        - incomplete_checks
      type: object
    AuditUnknownsV2:
      additionalProperties: true
      properties:
        excluded_dependencies:
          description: Source-excluded groups by name, version and reason.
          items:
            $ref: '#/components/schemas/AuditExcludedDependency'
          type: array
        metadata:
          description: >-
            Unevaluated per-coordinate metadata checks, counted independently
            for each check family.
          items:
            $ref: '#/components/schemas/AuditMetadataUnknownV2'
          type: array
        resolution:
          description: Actual resolver diagnostics, separate from source and metadata gaps.
          items:
            $ref: '#/components/schemas/AuditResolutionGap'
          type: array
        sources:
          description: Distinct input files with outgoing dependency coverage gaps.
          items:
            $ref: '#/components/schemas/AuditSourceGap'
          type: array
        vulnerabilities:
          description: >-
            Coordinates with unknown, unsupported or qualified advisory
            assessment evidence; these may coexist with confirmed findings.
          items:
            $ref: '#/components/schemas/AuditVulnerabilityUnknownV2'
          type: array
      required:
        - vulnerabilities
        - metadata
        - sources
        - resolution
        - excluded_dependencies
      type: object
    AuditCoverageV3:
      additionalProperties: true
      description: >-
        Independent check coverage over eligible exact coordinates. Empty
        findings do not establish complete or globally fresh checks.
      properties:
        outdated:
          $ref: '#/components/schemas/AuditMetadataCoverage'
        vulnerabilities:
          $ref: '#/components/schemas/AuditVulnerabilityCoverage'
      required:
        - vulnerabilities
        - outdated
      type: object
    AuditFindingsV3:
      additionalProperties: true
      properties:
        duplicates:
          description: >-
            Registry/name groups with multiple distinct eligible versions across
            the combined upload.
          items:
            $ref: '#/components/schemas/AuditDuplicateFindingV2'
          type: array
        outdated:
          description: Coordinates behind the metadata source latest version.
          items:
            $ref: '#/components/schemas/AuditOutdatedFindingV2'
          type: array
        vulnerabilities:
          description: >-
            Confirmed affected coordinate/advisory findings with input
            attribution.
          items:
            $ref: '#/components/schemas/AuditVulnerabilityFindingV2'
          type: array
      required:
        - vulnerabilities
        - outdated
        - duplicates
      type: object
    AuditLifecycle:
      additionalProperties: true
      description: >-
        Canonical lifecycle rendering path for v3, independent of advisories,
        version selection and remediation policy. Unsupported archival is
        not_collected. Empty findings alone never establish health.
      properties:
        content_safety:
          additionalProperties: true
          description: >-
            Publisher-content normalization applied to lifecycle fields; no raw
            content is logged.
          properties:
            filtered:
              description: Whether normalization changed lifecycle publisher content.
              type: boolean
          required:
            - filtered
          type: object
        coverage:
          additionalProperties: true
          description: >-
            Independent native deprecation, withdrawal and archival check
            coverage over eligible exact coordinates.
          properties:
            deprecation:
              $ref: '#/components/schemas/AuditLifecycleCoverageFacet'
            registry_archival:
              $ref: '#/components/schemas/AuditLifecycleCoverageFacet'
            repository_archival:
              $ref: '#/components/schemas/AuditLifecycleCoverageFacet'
            withdrawal:
              $ref: '#/components/schemas/AuditLifecycleCoverageFacet'
          required:
            - deprecation
            - withdrawal
            - registry_archival
            - repository_archival
          type: object
        findings:
          description: >-
            Native source events grouped independently of vulnerabilities; each
            preserves distinct attributed observations.
          items:
            $ref: '#/components/schemas/AuditLifecycleFinding'
          type: array
        retained_warnings:
          description: >-
            Ambiguous legacy warning rows retained once without an invented
            native classification.
          items:
            $ref: '#/components/schemas/AuditLifecycleWarning'
          type: array
        unknowns:
          description: >-
            Unknown native check outcomes with exact coordinate/path
            attribution; collection limits are excluded.
          items:
            $ref: '#/components/schemas/AuditLifecycleUnknown'
          type: array
      required:
        - findings
        - retained_warnings
        - coverage
        - unknowns
        - content_safety
      type: object
    AuditSummaryV3:
      additionalProperties: true
      description: >-
        V3 counts preserve advisory/outdated/duplicate meanings while native
        events, retained warnings and incomplete checks remain distinct.
      properties:
        dependencies:
          description: >-
            Distinct eligible registry/name/version coordinates, independent of
            metadata availability.
          minimum: 0
          type: integer
        duplicates:
          description: >-
            Number of registry/name groups in findings.duplicates with multiple
            distinct versions.
          minimum: 0
          type: integer
        excluded_dependencies:
          description: >-
            Distinct source-excluded name/version/reason groups; not counted as
            eligible dependencies.
          minimum: 0
          type: integer
        incomplete_checks:
          description: >-
            Vulnerability unknown/unsupported counts plus outdated metadata gap
            rows plus lifecycle unknown rows. not_collected/not_applicable
            lifecycle limits are excluded; a lower count than v2 alone does not
            prove improved evidence.
          minimum: 0
          type: integer
        incomplete_sources:
          description: Distinct input files with outgoing-dependency coverage gaps.
          minimum: 0
          type: integer
        lifecycle:
          description: Native source events, not vulnerability/advisory counts.
          minimum: 0
          type: integer
        outdated:
          description: Number of coordinate findings in findings.outdated.
          minimum: 0
          type: integer
        retained_lifecycle_warnings:
          description: Retained ambiguous legacy warning rows.
          minimum: 0
          type: integer
        vulnerabilities:
          description: >-
            Number of coordinate/advisory findings in findings.vulnerabilities,
            not unique advisory IDs.
          minimum: 0
          type: integer
      required:
        - dependencies
        - vulnerabilities
        - outdated
        - duplicates
        - excluded_dependencies
        - incomplete_sources
        - incomplete_checks
        - lifecycle
        - retained_lifecycle_warnings
      type: object
    AuditUnknownsV3:
      additionalProperties: true
      description: >-
        Advisory, outdated, source, resolution and eligibility gaps; native
        lifecycle uncertainty is reported separately in lifecycle.unknowns.
      properties:
        excluded_dependencies:
          description: Source-excluded groups by name, version and reason.
          items:
            $ref: '#/components/schemas/AuditExcludedDependency'
          type: array
        metadata:
          description: >-
            Unassessed outdated checks. Native deprecation and withdrawal
            uncertainty is in lifecycle.unknowns.
          items:
            $ref: '#/components/schemas/AuditMetadataUnknownV3'
          type: array
        resolution:
          description: Actual resolver diagnostics, separate from source and metadata gaps.
          items:
            $ref: '#/components/schemas/AuditResolutionGap'
          type: array
        sources:
          description: Distinct input files with outgoing dependency coverage gaps.
          items:
            $ref: '#/components/schemas/AuditSourceGap'
          type: array
        vulnerabilities:
          description: >-
            Coordinates with unknown, unsupported or qualified advisory
            assessment evidence; these may coexist with confirmed findings.
          items:
            $ref: '#/components/schemas/AuditVulnerabilityUnknownV2'
          type: array
      required:
        - vulnerabilities
        - metadata
        - sources
        - resolution
        - excluded_dependencies
      type: object
    DependencyDiffAcceptedRequest:
      description: >-
        Dependency diff AcceptedRequest contract; response evidence remains
        producer-owned.
      properties:
        analysis:
          description: Requested optional analysis sections.
          properties:
            advisories:
              description: Current advisory assessments and independently qualified deltas.
              type: boolean
            direct_reviews:
              description: >-
                Exact eligible direct-version reviews and independent completion
                coverage.
              type: boolean
          required:
            - advisories
            - direct_reviews
          type: object
        base:
          $ref: '#/components/schemas/DependencyDiffAcceptedSide'
          description: Base selected input snapshot.
        head:
          $ref: '#/components/schemas/DependencyDiffAcceptedSide'
          description: Head selected input snapshot.
        schema_version:
          description: Version of this dependency comparison envelope.
          minimum: 1
          type: integer
        selection:
          description: Requested native groups and manifest resolution policy.
          properties:
            groups:
              description: >-
                All alone or a union of producer-supported native group
                selectors.
              items:
                type: string
              minItems: 1
              type: array
            unlocked_manifests:
              description: ' Open response vocabulary; known values: resolve, recorded_only. Unfamiliar values retain producer meaning; do not infer pass/safe.'
              type: string
          required:
            - groups
            - unlocked_manifests
          type: object
      required:
        - schema_version
        - base
        - head
        - selection
        - analysis
      type: object
    DependencyDiffSection:
      description: >-
        Dependency diff Section contract; response evidence remains
        producer-owned.
      properties:
        coverage:
          description: Independent coverage and reasons for missing evidence.
          properties:
            reasons:
              description: >-
                For advisory sections, new reports emit exhaustive causes of
                partial inventory or assessment across both sides, sorted and
                deduplicated. Each exposure-side coverage emits its own
                exhaustive reasons. git_registry_checks_not_supported,
                git_dependency_graph_unavailable, and
                git_source_binding_unavailable are expected Git coverage limits;
                umbrella_members_not_captured and all independent failure causes
                remain distinct. An absent list in an older report does not
                prove that a partial status has only informational causes.
                Response reason vocabulary remains open.
              items:
                type: string
              type: array
              uniqueItems: true
          type: object
        data:
          description: Unmodified producer evidence for this section.
          oneOf:
            - type: object
            - type: array
            - type: string
            - type: number
            - type: boolean
            - type: 'null'
        status:
          description: >-
            Known values: not_requested, complete, partial, unavailable.
            Consumers must preserve unknown future values.
          type: string
      required:
        - status
      type: object
    DependencyDiffChange:
      description: >-
        Dependency diff Change contract; response evidence remains
        producer-owned.
      properties:
        after_ids:
          description: >-
            Head-side occurrence or declaration identities participating in this
            change.
          items:
            type: string
          type: array
        after_versions:
          description: Head-side versions for this qualified source change.
          items:
            type:
              - string
              - 'null'
          type: array
        before_ids:
          description: >-
            Base-side occurrence or declaration identities participating in this
            change.
          items:
            type: string
          type: array
        before_versions:
          description: Base-side versions for this qualified source change.
          items:
            type:
              - string
              - 'null'
          type: array
        directness:
          description: >-
            Direct, transitive or unknown according to native
            binding/reachability proof.
          properties:
            base:
              description: Base selected input snapshot.
              type: string
            head:
              description: Head selected input snapshot.
              type: string
          required:
            - base
            - head
          type: object
        id:
          description: Opaque side-local evidence identity; never compare IDs across sides.
          type: string
        kind:
          description: Producer evidence kind; response vocabulary is open.
          type: string
        ownership:
          description: >-
            Recorded dependency evidence is distinct from proven effective
            ownership.
          type: string
        package:
          $ref: '#/components/schemas/DependencyDiffPackage'
          description: >-
            Canonical package identity, distinct from authored alias or
            capability.
        pairing_basis:
          description: Why a unique arrow or ambiguous set is represented.
          type: string
        retained:
          description: Unchanged occurrence identities retained within this source context.
          properties:
            base:
              description: Base selected input snapshot.
              items:
                type: string
              type: array
            head:
              description: Head selected input snapshot.
              items:
                type: string
              type: array
          required:
            - base
            - head
          type: object
        retained_elsewhere:
          description: >-
            Versions retained in other source contexts; these do not hide a
            local upgrade.
          items:
            properties:
              source_key:
                description: Repository-relative source key for this evidence.
                type: string
              versions:
                description: Producer versions evidence.
                items:
                  type:
                    - string
                    - 'null'
                type: array
            required:
              - source_key
              - versions
            type: object
          type: array
        source_key:
          description: Repository-relative source key for this evidence.
          type: string
        unit_key:
          description: Producer semantic resolution-unit key.
          items:
            type: string
          type: array
      required:
        - id
        - source_key
        - unit_key
        - package
        - ownership
        - before_ids
        - after_ids
        - before_versions
        - after_versions
        - kind
        - pairing_basis
        - directness
        - retained
        - retained_elsewhere
      type: object
    DependencyDiffDeclarationChange:
      description: >-
        Dependency diff DeclarationChange contract; response evidence remains
        producer-owned.
      properties:
        after_id:
          description: Unique head declaration ID, or null for absence or ambiguity.
          type:
            - string
            - 'null'
        after_ids:
          description: >-
            Head-side occurrence or declaration identities participating in this
            change.
          items:
            type: string
          type: array
        before_id:
          description: Unique base declaration ID, or null for absence or ambiguity.
          type:
            - string
            - 'null'
        before_ids:
          description: >-
            Base-side occurrence or declaration identities participating in this
            change.
          items:
            type: string
          type: array
        binding_transitions:
          description: Source-local binding changes independent of occurrence cancellation.
          items:
            $ref: '#/components/schemas/DependencyDiffBindingTransition'
          type: array
        id:
          description: Opaque side-local evidence identity; never compare IDs across sides.
          type: string
        kind:
          description: Producer evidence kind; response vocabulary is open.
          type: string
        match_key:
          description: >-
            Producer semantic declaration comparison key, excluding side-local
            IDs.
          items:
            oneOf:
              - type: object
              - type: array
              - type: string
              - type: number
              - type: boolean
              - type: 'null'
          type: array
      required:
        - id
        - kind
        - match_key
        - binding_transitions
      type: object
    DependencyDiffReviewSection:
      description: >-
        Dependency diff ReviewSection contract; response evidence remains
        producer-owned. For known complete or partial status, data and coverage
        are required; unfamiliar statuses retain producer meaning.
      properties:
        coverage:
          $ref: '#/components/schemas/DependencyDiffReviewCoverage'
          description: Independent coverage and reasons for missing evidence.
        data:
          description: Unmodified producer evidence for this section.
          items:
            $ref: '#/components/schemas/DependencyDiffReview'
          type: array
        status:
          description: >-
            Producer evidence status; unfamiliar values must not be interpreted
            as pass or safe.
          type: string
      required:
        - status
      type: object
    DependencyDiffSnapshot:
      description: >-
        Dependency diff Snapshot contract; response evidence remains
        producer-owned.
      properties:
        accepted_files:
          description: Accepted relative paths and SHA-256 digests of the selected bytes.
          items:
            properties:
              path:
                description: Repository-relative path within the selected input.
                type: string
              sha256:
                description: Producer sha256 evidence.
                pattern: ^[0-9a-f]{64}$
                type: string
            required:
              - path
              - sha256
            type: object
          type: array
        bindings:
          description: Exact or qualified declaration-to-occurrence associations.
          items:
            $ref: '#/components/schemas/DependencyDiffBinding'
          type: array
        coverage:
          description: >-
            Source-local coverage. reachability summaries retain manifest_path,
            source_key, complete, basis and sorted unique reason-code strings,
            plus reachability_id joining this snapshot reachability[].id.
            Detailed attributed causes remain on the referenced proof. New
            schema-v1 fields may be absent in older results.
          type: object
        declarations:
          description: >-
            Authored dependency declarations, retaining aliases and requirement
            owners.
          items:
            $ref: '#/components/schemas/DependencyDiffDeclaration'
          type: array
        occurrences:
          description: Source-local dependency occurrences, retaining multiplicity.
          items:
            $ref: '#/components/schemas/DependencyDiffOccurrence'
          type: array
        parser_versions:
          description: Native parser versions, or null for an explicitly empty side.
          type:
            - object
            - 'null'
        reachability:
          description: Source-local graph reachability evidence and qualifications.
          items:
            $ref: '#/components/schemas/DependencyDiffReachability'
          type: array
        resolution_units:
          description: Resolution units joining associated sources and manifests.
          items:
            type: object
          type: array
        selection:
          description: Requested native groups and manifest resolution policy.
          type: object
        side:
          description: ' Open response vocabulary; known values: base, head. Unfamiliar values retain producer meaning; do not infer pass/safe.'
          type: string
        sources:
          description: >-
            Source-local dependency evidence and recorded/effective ownership
            context.
          items:
            $ref: '#/components/schemas/DependencyDiffSource'
          type: array
      required:
        - side
        - accepted_files
        - sources
        - resolution_units
        - declarations
        - bindings
        - occurrences
        - coverage
        - selection
        - parser_versions
        - reachability
      type: object
    AuditMetadataCoverage:
      additionalProperties: true
      description: >-
        Per-check metadata coverage. Cached/read-through metadata can be
        unavailable or not collected; those outcomes remain explicit. Detailed
        per-coordinate outcomes and occurrence attribution are in
        unknowns.metadata.
      properties:
        candidates_count:
          description: Number of distinct coordinates considered for this metadata check.
          minimum: 0
          type: integer
        checked_count:
          description: >-
            Coordinates with a checked outcome for this metadata check, whether
            or not a finding exists.
          minimum: 0
          type: integer
        not_collected_count:
          description: >-
            Coordinates for which this registry metadata check was not
            collected.
          minimum: 0
          type: integer
        not_collected_registries:
          description: >-
            Distinct registries contributing not_collected outcomes for this
            check.
          items:
            $ref: '#/components/schemas/AuditRegistry'
          type: array
        unknown_count:
          description: Coordinates with an unknown outcome for this metadata check.
          minimum: 0
          type: integer
      required:
        - candidates_count
        - checked_count
        - unknown_count
        - not_collected_count
        - not_collected_registries
      type: object
    AuditDuplicateCoverage:
      additionalProperties: true
      properties:
        candidates_count:
          description: >-
            Number of distinct eligible registry/name/version coordinates
            considered for duplicate grouping.
          minimum: 0
          type: integer
        excluded_occurrences_count:
          description: >-
            Number of occurrences without an eligible coordinate and excluded
            from duplicate grouping.
          minimum: 0
          type: integer
      required:
        - candidates_count
        - excluded_occurrences_count
      type: object
    AuditSourceCoverage:
      additionalProperties: true
      description: >-
        Per-owner source resolution coverage; it is independent of advisory
        coverage.
      properties:
        owner_id:
          description: >-
            Source owner identifier matching occurrences[].id,
            inputs.manifests[].id or inputs.subjects[].id.
          type: string
        reasons:
          description: Producer-defined bounded source coverage reasons.
          items:
            type: string
          type: array
        state:
          description: >-
            Completeness of outgoing dependency evidence for this source owner,
            independent of assessment and metadata coverage. Open response
            vocabulary; clients must accept unfamiliar values.
          type: string
      required:
        - owner_id
        - state
        - reasons
      type: object
    AuditVulnerabilityCoverage:
      additionalProperties: true
      description: >-
        Vulnerability assessment coverage over distinct eligible coordinates.
        Checked negatives describe the available local advisory corpus, not
        global freshness. Detailed unknown outcomes and occurrence attribution
        are in unknowns.vulnerabilities.
      properties:
        candidates_count:
          description: Number of distinct coordinates submitted for advisory assessment.
          minimum: 0
          type: integer
        checked_count:
          description: >-
            Coordinates assessed without an unknown or unsupported outcome;
            findings may still be present.
          minimum: 0
          type: integer
        unknown_count:
          description: >-
            Coordinates whose advisory assessment could not reach a known
            outcome.
          minimum: 0
          type: integer
        unsupported_count:
          description: >-
            Coordinates in registries unsupported by the advisory assessment
            source.
          minimum: 0
          type: integer
        unsupported_registries:
          description: Distinct registries contributing unsupported advisory assessments.
          items:
            $ref: '#/components/schemas/AuditRegistry'
          type: array
      required:
        - candidates_count
        - checked_count
        - unknown_count
        - unsupported_count
        - unsupported_registries
      type: object
    AuditDeprecatedFinding:
      additionalProperties: true
      properties:
        coordinate:
          $ref: '#/components/schemas/AuditCoordinate'
          description: Exact coordinate whose registry metadata reports deprecation.
        occurrence_ids:
          description: >-
            Identifiers in occurrences[].id attributing this deprecated
            coordinate to input records.
          items:
            type: string
          type: array
        reason:
          description: Deprecation reason supplied by registry metadata.
          type: string
      required:
        - coordinate
        - occurrence_ids
        - reason
      type: object
    AuditDuplicateFinding:
      additionalProperties: true
      description: >-
        One canonical registry/name with at least two distinct literal version
        identifiers. Repeated occurrences of one version are not a duplicate
        group.
      properties:
        name:
          description: >-
            Canonical package name with multiple versions in the combined
            upload.
          type: string
        registry:
          $ref: '#/components/schemas/AuditRegistry'
          description: Registry shared by this duplicate package group.
        versions:
          description: >-
            Distinct version groups and their occurrence references; recompute
            groups when selecting a per-pair view.
          items:
            $ref: '#/components/schemas/AuditDuplicateVersion'
          type: array
      required:
        - registry
        - name
        - versions
      type: object
    AuditOutdatedFinding:
      additionalProperties: true
      description: >-
        An available newer version and its version delta; change_type never
        represents security severity.
      properties:
        change_type:
          description: >-
            Version delta classification, not security severity. Open response
            vocabulary; clients must accept unfamiliar values.
          type: string
        coordinate:
          $ref: '#/components/schemas/AuditCoordinate'
          description: Exact coordinate compared with the registry latest-version metadata.
        latest_version:
          description: >-
            Latest version reported by the metadata source; it is not a
            constraint-compatible or verified security remedy.
          type: string
        occurrence_ids:
          description: >-
            Identifiers in occurrences[].id attributing this outdated coordinate
            to input records.
          items:
            type: string
          type: array
      required:
        - coordinate
        - occurrence_ids
        - latest_version
        - change_type
      type: object
    AuditVulnerabilityFinding:
      additionalProperties: true
      description: >-
        One finding represents one advisory at one exact canonical coordinate,
        attached to all retained occurrences of that coordinate. Only
        vulnerability findings carry security severity.
      properties:
        advisory_id:
          description: Source advisory identifier selected for this affected coordinate.
          type: string
        aliases:
          description: Other source identifiers associated with the selected advisory.
          items:
            type: string
          type: array
        coordinate:
          $ref: '#/components/schemas/AuditCoordinate'
          description: Exact registry/name/version coordinate affected by this advisory.
        fixed_in_versions:
          description: >-
            Source-provided fixed versions; they are advisory evidence, not a
            constraint-compatible upgrade.
          items:
            type: string
          type: array
        malicious:
          description: Whether the advisory source identifies the release as malicious.
          type: boolean
        matched_ranges:
          description: >-
            Source advisory ranges matched by the recorded release; these are
            evidence, not caller upgrade constraints.
          items:
            type: string
          type: array
        occurrence_ids:
          description: >-
            Identifiers in occurrences[].id attributing this coordinate/advisory
            finding to original input records.
          items:
            type: string
          type: array
        related_advisory_ids:
          description: Advisory identifiers grouped as duplicates of the selected advisory.
          items:
            type: string
          type: array
        severity_score:
          description: Advisory-provided numeric score, or null when no score is available.
          type:
            - number
            - 'null'
        severity_type:
          description: Advisory-provided severity source/type, or null when absent.
          type:
            - string
            - 'null'
        summary:
          description: Advisory-provided summary, or null when the source has none.
          type:
            - string
            - 'null'
        verified_remedies:
          description: >-
            Candidate versions verified against all selected advisory evidence
            for this exact coordinate; caller constraints are not evaluated.
          items:
            type: string
          type: array
      required:
        - coordinate
        - occurrence_ids
        - advisory_id
        - aliases
        - related_advisory_ids
        - summary
        - severity_score
        - severity_type
        - malicious
        - matched_ranges
        - fixed_in_versions
        - verified_remedies
      type: object
    AuditDeclarationInput:
      additionalProperties: true
      description: Declaration attribution omits raw requirements and source URLs.
      properties:
        id:
          description: Inventory declaration identifier within this report.
          type: string
        manifest_path:
          description: Uploaded manifest filename that contains this declaration.
          type: string
        name:
          description: Dependency name recorded in the manifest declaration.
          type: string
        optional:
          description: >-
            Parser-recorded optionality as text: empty string when absent, true
            or false when explicitly supplied. Open response vocabulary; clients
            must accept unfamiliar values.
          type: string
        scope:
          description: >-
            The parser-recorded declaration scope; an empty string means the
            input supplied no scope.
          type: string
      required:
        - id
        - name
        - manifest_path
        - scope
        - optional
      type: object
    AuditLockfileInput:
      additionalProperties: true
      description: >-
        Allowlisted lockfile summary only; raw file contents, source URLs and
        unprojected context are omitted.
      properties:
        association_status:
          description: >-
            Whether manifest association was established, absent or ambiguous.
            Open response vocabulary; clients must accept unfamiliar values.
          type: string
        completeness:
          description: Parser-provided lockfile completeness value.
          type: string
        dependency_count:
          description: >-
            Number of native dependency records, not distinct assessed
            coordinates.
          minimum: 0
          type: integer
        format:
          description: Lockfile format identifier.
          type: string
        manifest_lock_consistency:
          description: >-
            Recorded consistency assessment; not_checked means manifest and
            lockfile agreement was not evaluated. Open response vocabulary;
            clients must accept unfamiliar values.
          type: string
        manifest_paths:
          description: >-
            Uploaded manifest filenames associated with this lockfile; file
            association does not establish reachability.
          items:
            type: string
          type: array
        omitted_context_counts:
          additionalProperties:
            minimum: 0
            type: integer
          description: Counts keyed by the producer-defined omitted-context category.
          type: object
        package_count:
          description: Number of package records in the native parsed lockfile.
          minimum: 0
          type: integer
        path:
          description: Uploaded relative filename of the parsed lockfile.
          type: string
        projection_notices:
          description: >-
            Producer notices describing limitations of the lockfile-to-inventory
            projection.
          items:
            type: string
          type: array
        requirement_count:
          description: >-
            Number of native requirement records; these do not certify caller
            constraint compatibility.
          minimum: 0
          type: integer
        structural_count:
          description: >-
            Number of native structural records projected as source subjects,
            separate from dependency occurrences.
          minimum: 0
          type: integer
      required:
        - path
        - format
        - completeness
        - manifest_paths
        - association_status
        - manifest_lock_consistency
        - package_count
        - structural_count
        - dependency_count
        - requirement_count
        - projection_notices
        - omitted_context_counts
      type: object
    AuditManifestInput:
      additionalProperties: true
      properties:
        id:
          description: Inventory manifest identifier within this report.
          type: string
        name:
          description: Package name recorded in the uploaded manifest.
          type: string
        path:
          description: Uploaded relative manifest filename used by manifest associations.
          type: string
        version:
          description: Manifest-declared root version; null when absent.
          type:
            - string
            - 'null'
      required:
        - id
        - name
        - version
        - path
      type: object
    AuditManifestResolution:
      additionalProperties: true
      description: >-
        Resolver diagnostics are bounded producer values; raw dependency
        requirements are not included.
      properties:
        diagnostics:
          description: Dependency-specific reasons for incomplete manifest resolution.
          items:
            $ref: '#/components/schemas/AuditResolutionDiagnostic'
          type: array
        path:
          description: Uploaded manifest filename for this resolution attempt.
          type: string
        status:
          description: >-
            Outcome of manifest dependency resolution; partial or failed
            evidence remains in the report. Open response vocabulary; clients
            must accept unfamiliar values.
          type: string
      required:
        - path
        - status
        - diagnostics
      type: object
    AuditSubjectInput:
      additionalProperties: true
      description: >-
        Structural lockfile subject evidence. Subjects can own source coverage
        but are not assessed occurrences or dependency counts.
      properties:
        id:
          description: Stable inventory identifier used as the source coverage owner_id.
          type: string
        lockfile_path:
          description: Uploaded lockfile filename that supplied this structural subject.
          type: string
        name:
          description: >-
            Native or generated structural subject name; it need not identify a
            registry package.
          type: string
        native_package_id:
          description: >-
            Native package identifier, including generated file-root identifier
            `0`; null for auxiliary records without a native package ID.
          type:
            - string
            - 'null'
        role:
          description: >-
            Native or projection-generated subject role, such as FILE_ROOT or
            CLJ_NIX_MAVEN_ARTIFACT.
          type: string
        version:
          description: Native subject version; null when not supplied.
          type:
            - string
            - 'null'
      required:
        - id
        - name
        - version
        - lockfile_path
        - native_package_id
        - role
      type: object
    AuditCoordinate:
      additionalProperties: true
      description: >-
        An exact canonical public registry coordinate, not an installed-artifact
        identity.
      properties:
        name:
          description: Canonical package name within the registry.
          type: string
        registry:
          $ref: '#/components/schemas/AuditRegistry'
          description: Registry identifying the package ecosystem.
        version:
          description: Exact package release selected for this coordinate.
          type: string
      required:
        - registry
        - name
        - version
      type: object
    AuditMetadataUnknown:
      additionalProperties: true
      description: >-
        An unevaluated metadata check; null reason is retained when the producer
        has no reason.
      properties:
        check:
          description: >-
            Metadata check family, such as deprecation or outdated. Open
            response vocabulary; clients must accept unfamiliar values.
          type: string
        coordinate:
          $ref: '#/components/schemas/AuditCoordinate'
          description: Exact coordinate whose metadata check was not fully evaluated.
        occurrence_ids:
          description: >-
            Identifiers in occurrences[].id attributing this metadata evidence
            gap to input records.
          items:
            type: string
          type: array
        reason:
          description: >-
            Producer reason this metadata check was not fully evaluated; null
            when no reason is available. Open response vocabulary; clients must
            accept unfamiliar values.
          type:
            - string
            - 'null'
        status:
          description: >-
            Outcome for this metadata check, such as unknown or not_collected.
            Open response vocabulary; clients must accept unfamiliar values.
          type: string
      required:
        - coordinate
        - occurrence_ids
        - check
        - status
        - reason
      type: object
    AuditVulnerabilityUnknown:
      additionalProperties: true
      properties:
        advisory_ids:
          description: >-
            Unknown advisory IDs are context, not confirmed findings or
            confirmed negatives.
          items:
            type: string
          type: array
        check:
          description: >-
            Assessment family for this evidence gap; currently vulnerabilities.
            Open response vocabulary; clients must accept unfamiliar values.
          type: string
        coordinate:
          $ref: '#/components/schemas/AuditCoordinate'
          description: >-
            Exact coordinate with incomplete, unsupported or qualified advisory
            evidence.
        occurrence_ids:
          description: >-
            Identifiers in occurrences[].id attributing this advisory evidence
            gap to input records.
          items:
            type: string
          type: array
        reasons:
          description: Bounded producer reasons explaining incomplete advisory assessment.
          items:
            type: string
          type: array
        status:
          description: >-
            Advisory assessment outcome for this coordinate; unknown or
            unsupported does not establish a clean result. Open response
            vocabulary; clients must accept unfamiliar values.
          type: string
      required:
        - coordinate
        - occurrence_ids
        - check
        - status
        - reasons
        - advisory_ids
      type: object
    AuditDeprecatedFindingV2:
      additionalProperties: true
      properties:
        coordinate:
          $ref: '#/components/schemas/AuditCoordinate'
          description: Exact coordinate whose registry metadata reports deprecation.
        paths:
          description: >-
            Sorted unique input paths locating this evidence; file association
            is not package reachability.
          items:
            type: string
          type: array
        reason:
          description: Deprecation reason supplied by registry metadata.
          type: string
      required:
        - coordinate
        - paths
        - reason
      type: object
    AuditDuplicateFindingV2:
      additionalProperties: true
      description: >-
        Multiple distinct recorded versions, not proof of conflicting
        requirements. Each origin describes an exact recorded target;
        unattributed requirements select no version.
      properties:
        name:
          description: >-
            Canonical package name with multiple versions in the combined
            upload.
          type: string
        registry:
          $ref: '#/components/schemas/AuditRegistry'
          description: Registry shared by this duplicate package group.
        unattributed_requirements:
          description: >-
            Relevant requirements with no asserted resolved target; these select
            no duplicate version.
          items:
            $ref: '#/components/schemas/AuditUnattributedRequirement'
          type: array
        versions:
          description: >-
            Distinct versions with source paths and requesting origins; these do
            not establish conflicting requirements.
          items:
            $ref: '#/components/schemas/AuditDuplicateVersionV2'
          type: array
      required:
        - registry
        - name
        - versions
        - unattributed_requirements
      type: object
    AuditOutdatedFindingV2:
      additionalProperties: true
      description: >-
        An available newer version and its version delta; change_type never
        represents security severity.
      properties:
        change_type:
          description: >-
            Version delta classification, not security severity. Currently
            major, minor, patch, unknown. Open response vocabulary; clients must
            accept unfamiliar values.
          type: string
        coordinate:
          $ref: '#/components/schemas/AuditCoordinate'
          description: Exact coordinate compared with the registry latest-version metadata.
        latest_version:
          description: >-
            Latest version reported by the metadata source; it is not a
            constraint-compatible or verified security remedy.
          type: string
        paths:
          description: >-
            Sorted unique input paths locating this evidence; file association
            is not package reachability.
          items:
            type: string
          type: array
      required:
        - coordinate
        - paths
        - latest_version
        - change_type
      type: object
    AuditVulnerabilityFindingV2:
      additionalProperties: true
      description: >-
        One advisory at one exact canonical coordinate, located by source paths.
        Only vulnerability findings carry security severity.
      properties:
        advisory_id:
          description: Source advisory identifier selected for this affected coordinate.
          type: string
        aliases:
          description: Other source identifiers associated with the selected advisory.
          items:
            type: string
          type: array
        coordinate:
          $ref: '#/components/schemas/AuditCoordinate'
          description: Exact registry/name/version coordinate affected by this advisory.
        fixed_in_versions:
          description: >-
            Source-provided fixed versions; they are advisory evidence, not a
            constraint-compatible upgrade.
          items:
            type: string
          type: array
        malicious:
          description: Whether the advisory source identifies the release as malicious.
          type: boolean
        matched_ranges:
          description: >-
            Source advisory ranges matched by the recorded release; these are
            evidence, not caller upgrade constraints.
          items:
            type: string
          type: array
        paths:
          description: >-
            Sorted unique input paths locating this evidence; file association
            is not package reachability.
          items:
            type: string
          type: array
        related_advisory_ids:
          description: Advisory identifiers grouped as duplicates of the selected advisory.
          items:
            type: string
          type: array
        severity_score:
          description: Advisory-provided numeric score, or null when no score is available.
          type:
            - number
            - 'null'
        severity_type:
          description: Advisory-provided severity source/type, or null when absent.
          type:
            - string
            - 'null'
        summary:
          description: Advisory-provided summary, or null when the source has none.
          type:
            - string
            - 'null'
        verified_remedies:
          description: >-
            Candidate versions verified against all selected advisory evidence
            for this exact coordinate; caller constraints are not evaluated.
          items:
            type: string
          type: array
      required:
        - coordinate
        - paths
        - advisory_id
        - aliases
        - related_advisory_ids
        - summary
        - severity_score
        - severity_type
        - malicious
        - matched_ranges
        - fixed_in_versions
        - verified_remedies
      type: object
    AuditRemediationLimits:
      additionalProperties: true
      description: >-
        Producer-owned output limits and omission counts. Existing omission
        evidence remains open and is forwarded unchanged.
      properties:
        omitted_search_details:
          description: >-
            Number of search-detail entries omitted across all recommendations,
            including omitted recommendations. Optional only for immutable older
            reports.
          minimum: 0
          type: integer
      type: object
    AuditRemediationRecommendation:
      additionalProperties: true
      description: >-
        Producer-owned recommendation. checks and request_checks concern
        selected actions; search_details records whole-search obstacles,
        including losing alternatives. detail_status concerns retained trace
        only. Search fields are either both absent in older immutable reports or
        both present. retained plus empty means no recorded obstacle within
        existing selection policy; it certifies neither exhaustive search,
        native resolution nor a safe/applicable fix. not_retained omits the
        entire search collection and search_details is empty.
      properties:
        blockers:
          description: Requests that block this remediation recommendation.
          items:
            $ref: '#/components/schemas/AuditRemediationBlocker'
          type: array
        request_checks:
          description: >-
            Additive source-local request evidence. Optional only for immutable
            older recommendations; current producers emit an array, including
            when empty.
          items:
            $ref: '#/components/schemas/AuditRemediationRequestCheck'
          type: array
        search_detail_status:
          description: >-
            Whether the whole search collection survived output allocation;
            independent of trace detail_status. Optional only for immutable
            older reports. Open producer vocabulary; accept unfamiliar values.
            Known values: retained, not_retained.
          type: string
        search_details:
          description: >-
            Unavailable answers and observed work stops retained from this
            subject search, including losing alternatives. Empty with retained
            status means no recorded obstacle within the existing selection
            policy, not exhaustive resolution. Optional only for immutable older
            reports.
          items:
            $ref: '#/components/schemas/AuditRemediationSearchDetail'
          type: array
      type: object
    AuditRemediationTrace:
      additionalProperties: true
      description: >-
        Producer-retained occurrence and relation trace, independent of
        whole-search detail retention.
      properties:
        relations:
          description: >-
            Retained source-local relations and their screened requests. Trace
            retention is independent of whole-search detail retention.
          items:
            $ref: '#/components/schemas/AuditRemediationRelation'
          type: array
      type: object
    AuditExcludedDependency:
      additionalProperties: true
      description: >-
        Recorded dependency excluded from public-coordinate checks by source
        eligibility. This is not a failed public package lookup.
      properties:
        name:
          description: Recorded source-excluded dependency name.
          type: string
        paths:
          description: >-
            Sorted unique input paths locating this evidence; file association
            is not package reachability.
          items:
            type: string
          type: array
        reason:
          description: Reason this evidence is incomplete or excluded.
          type: string
        version:
          description: Recorded version; null when the source did not record one.
          type:
            - string
            - 'null'
      required:
        - name
        - version
        - paths
        - reason
      type: object
    AuditMetadataUnknownV2:
      additionalProperties: true
      description: >-
        An unevaluated metadata check; null reason is retained when the producer
        has no reason.
      properties:
        check:
          description: >-
            Currently deprecation, outdated. Open response vocabulary; clients
            must accept unfamiliar values.
          type: string
        coordinate:
          $ref: '#/components/schemas/AuditCoordinate'
          description: Exact coordinate whose metadata check was not fully evaluated.
        paths:
          description: >-
            Sorted unique input paths locating this evidence; file association
            is not package reachability.
          items:
            type: string
          type: array
        reason:
          description: >-
            Reason the check was not evaluated, or null when absent. Currently
            metadata_unavailable, lookup_failed or comparison_unknown. Open
            response vocabulary; clients must accept unfamiliar values.
          type:
            - string
            - 'null'
        status:
          description: >-
            Currently unknown, not_collected. Open response vocabulary; clients
            must accept unfamiliar values.
          type: string
      required:
        - coordinate
        - paths
        - check
        - status
        - reason
      type: object
    AuditResolutionGap:
      additionalProperties: true
      description: >-
        Actual resolver diagnostic. A null name describes the source as a whole.
        Reasons distinguish unresolved dependencies, skipped requirements,
        unavailable metadata and incomplete dependency lists.
      properties:
        name:
          description: >-
            Recorded dependency or requester name; null on a source-wide
            resolution diagnostic.
          type:
            - string
            - 'null'
        path:
          description: Input filename locating this evidence.
          type: string
        reason:
          description: Reason this evidence is incomplete or excluded.
          type: string
      required:
        - path
        - name
        - reason
      type: object
    AuditSourceGap:
      additionalProperties: true
      description: >-
        Distinct outgoing-dependency coverage gaps in this input file. These are
        not package metadata lookup failures or inferred unresolved packages.
      properties:
        path:
          description: Input filename locating this evidence.
          type: string
        reasons:
          description: Distinct reasons describing incomplete evidence in this source file.
          items:
            type: string
          type: array
      required:
        - path
        - reasons
      type: object
    AuditVulnerabilityUnknownV2:
      additionalProperties: true
      properties:
        advisory_ids:
          description: >-
            Unknown advisory IDs are context, not confirmed findings or
            confirmed negatives.
          items:
            type: string
          type: array
        check:
          description: >-
            Currently vulnerabilities. Open response vocabulary; clients must
            accept unfamiliar values.
          type: string
        coordinate:
          $ref: '#/components/schemas/AuditCoordinate'
          description: >-
            Exact coordinate with incomplete, unsupported or qualified advisory
            evidence.
        paths:
          description: >-
            Sorted unique input paths locating this evidence; file association
            is not package reachability.
          items:
            type: string
          type: array
        reasons:
          description: Bounded producer reasons explaining incomplete advisory assessment.
          items:
            type: string
          type: array
        status:
          description: >-
            Currently affected, non_affecting, unknown, unsupported. Open
            response vocabulary; clients must accept unfamiliar values.
          type: string
      required:
        - coordinate
        - paths
        - check
        - status
        - reasons
        - advisory_ids
      type: object
    AuditLifecycleCoverageFacet:
      additionalProperties: true
      description: >-
        Exact candidates partition into checked, unknown, not_collected and
        not_applicable. Checked includes positives and observed negatives. Zero
        candidates means not assessed. Collection limits do not contribute
        incomplete checks.
      properties:
        candidates_count:
          description: >-
            Number of eligible exact coordinates considered; zero does not
            establish package health.
          minimum: 0
          type: integer
        checked_count:
          description: >-
            Coordinates with a completed check, including both positive findings
            and observed negatives.
          minimum: 0
          type: integer
        not_applicable_count:
          description: >-
            Candidates whose registry provides no signal for this check.
            Currently PyPI deprecation only; neither an incomplete check nor a
            checked negative.
          minimum: 0
          type: integer
        not_applicable_registries:
          description: Unique registries with actual not-applicable candidates.
          items:
            $ref: '#/components/schemas/AuditRegistry'
          type: array
        not_collected_count:
          description: >-
            Coordinates limited by unavailable integration collection; excluded
            from incomplete-check counts.
          minimum: 0
          type: integer
        not_collected_registries:
          description: Unique registries represented by not-collected candidates.
          items:
            $ref: '#/components/schemas/AuditRegistry'
          type: array
        unknown_count:
          description: >-
            Coordinates whose check could not establish an outcome; each native
            unknown contributes an incomplete check.
          minimum: 0
          type: integer
      required:
        - candidates_count
        - checked_count
        - unknown_count
        - not_collected_count
        - not_collected_registries
        - not_applicable_count
        - not_applicable_registries
      type: object
    AuditLifecycleFinding:
      additionalProperties: true
      description: >-
        One native source event. Package events have version null and aggregate
        selected versions through attributed observations; release/file events
        retain their affected version.
      properties:
        category:
          description: ' Open producer vocabulary; accept unfamiliar values. Known values: deprecation, withdrawal.'
          type: string
        kind:
          description: ' Open producer vocabulary; accept unfamiliar values. Known values: deprecated, retired, abandoned, discontinued, yanked, partially_yanked, retracted, unlisted.'
          type: string
        name:
          description: Canonical package name within the event registry.
          type: string
        observations:
          description: >-
            Distinct source version/time/reason/reason-code/replacement
            observations, each retaining its own affected coordinates and paths.
          items:
            $ref: '#/components/schemas/AuditLifecycleObservation'
          type: array
        registry:
          $ref: '#/components/schemas/AuditRegistry'
        scope:
          description: ' Open producer vocabulary; accept unfamiliar values. Known values: package, release, files.'
          type: string
        source:
          description: >-
            Native observation field, independent of the legacy compatibility
            flag.
          type: string
        version:
          description: >-
            Affected release; null for package-wide events whose selected
            versions remain in observations.
          type:
            - string
            - 'null'
      required:
        - registry
        - name
        - version
        - category
        - kind
        - scope
        - source
        - observations
      type: object
    AuditLifecycleWarning:
      additionalProperties: true
      description: >-
        Ambiguous historical NuGet warning retained exactly once; native checks
        remain unknown.
      properties:
        classification:
          description: ' Open producer vocabulary; accept unfamiliar values. Known values: legacy_unclassified.'
          type: string
        coordinate:
          $ref: '#/components/schemas/AuditCoordinate'
        paths:
          description: Nonempty sorted unique input paths locating the retained warning.
          items:
            type: string
          minItems: 1
          type: array
          uniqueItems: true
        reason:
          description: >-
            Normalized retained legacy warning prose; render once alongside
            native uncertainty.
          type: string
      required:
        - coordinate
        - paths
        - classification
        - reason
      type: object
    AuditLifecycleUnknown:
      additionalProperties: true
      description: >-
        Failed acquisition, successful absence and absent native capture remain
        distinct. Each row contributes one incomplete check.
      properties:
        check:
          description: ' Open producer vocabulary; accept unfamiliar values. Known values: deprecation, withdrawal, registry_archival, repository_archival.'
          type: string
        coordinate:
          $ref: '#/components/schemas/AuditCoordinate'
        paths:
          description: >-
            Nonempty sorted unique input paths locating the unknown check
            outcome.
          items:
            type: string
          minItems: 1
          type: array
          uniqueItems: true
        reason:
          description: ' Open producer vocabulary; accept unfamiliar values. Known values: lookup_failed, metadata_unavailable, native_evidence_unavailable.'
          type: string
        status:
          description: ' Open producer vocabulary; accept unfamiliar values. Known values: unknown.'
          type: string
      required:
        - coordinate
        - paths
        - check
        - status
        - reason
      type: object
    AuditMetadataUnknownV3:
      additionalProperties: true
      description: >-
        An unevaluated metadata check; null reason is retained when the producer
        has no reason.
      properties:
        check:
          description: >-
            Currently outdated; deprecation uncertainty moved to
            lifecycle.unknowns. Open response vocabulary; accept unfamiliar
            values.
          type: string
        coordinate:
          $ref: '#/components/schemas/AuditCoordinate'
          description: Exact coordinate whose metadata check was not fully evaluated.
        paths:
          description: >-
            Sorted unique input paths locating this evidence; file association
            is not package reachability.
          items:
            type: string
          type: array
        reason:
          description: >-
            Reason the check was not evaluated, or null when absent. Currently
            metadata_unavailable, lookup_failed or comparison_unknown. Open
            response vocabulary; clients must accept unfamiliar values.
          type:
            - string
            - 'null'
        status:
          description: >-
            Currently unknown, not_collected. Open response vocabulary; clients
            must accept unfamiliar values.
          type: string
      required:
        - coordinate
        - paths
        - check
        - status
        - reason
      type: object
    DependencyDiffAcceptedSide:
      description: >-
        Dependency diff AcceptedSide contract; response evidence remains
        producer-owned.
      properties:
        state:
          description: ' Open response vocabulary; known values: supplied, empty. Unfamiliar values retain producer meaning; do not infer pass/safe.'
          type: string
      required:
        - state
      type: object
    DependencyDiffPackage:
      description: >-
        Dependency diff Package contract; response evidence remains
        producer-owned.
      properties:
        name:
          description: Package identity supplied by the producer.
          type:
            - string
            - 'null'
        registry:
          description: Producer registry identity; response vocabulary is open.
          type:
            - string
            - 'null'
      required:
        - registry
        - name
      type: object
    DependencyDiffBindingTransition:
      description: >-
        Dependency diff BindingTransition contract; response evidence remains
        producer-owned.
      properties:
        after_versions:
          description: Head-side versions for this qualified source change.
          items:
            type: string
          type: array
        base_status:
          description: Base binding qualification.
          type: string
        base_target:
          $ref: '#/components/schemas/DependencyDiffTarget'
          description: Exact eligible base artifact target, or null when unavailable.
        before_versions:
          description: Base-side versions for this qualified source change.
          items:
            type: string
          type: array
        declared_package:
          description: >-
            Authored package identity, separately retained from a provider
            artifact.
          oneOf:
            - $ref: '#/components/schemas/DependencyDiffPackage'
            - type: 'null'
        head_status:
          description: Head binding qualification.
          type: string
        head_target:
          $ref: '#/components/schemas/DependencyDiffTarget'
          description: Exact eligible head artifact target, or null when unavailable.
        package:
          description: >-
            Canonical package identity, distinct from authored alias or
            capability.
          oneOf:
            - $ref: '#/components/schemas/DependencyDiffPackage'
            - type: 'null'
        recorded_before_versions:
          description: Versions recorded in the base source binding.
          items:
            type: string
          type: array
        resolved_before_versions:
          description: >-
            Separately resolved base versions; never substitutes for recorded
            evidence.
          items:
            type: string
          type: array
        review_eligibility:
          description: >-
            Eligibility status and actual reason when this transition cannot be
            reviewed.
          properties:
            reason:
              description: >-
                Concrete reason for unavailable, unassessed or omitted evidence;
                omitted when absent.
              type: string
            status:
              description: >-
                Producer evidence status; unfamiliar values must not be
                interpreted as pass or safe.
              type: string
          required:
            - status
          type: object
        source_key:
          description: Repository-relative source key for this evidence.
          type: string
      required:
        - source_key
        - package
        - declared_package
        - base_target
        - head_target
        - before_versions
        - after_versions
        - recorded_before_versions
        - resolved_before_versions
        - base_status
        - head_status
        - review_eligibility
      type: object
    DependencyDiffReviewCoverage:
      description: >-
        Counts deduplicated canonical package/from/to tuples. Completed includes
        assessments omitted for encoded size; returned counts completed results
        whose evidence is present. Source/declaration references retain fan-out.
      properties:
        completed:
          description: >-
            Completed tuples, including assessed results omitted for encoded
            size.
          minimum: 0
          type: integer
        eligible:
          description: Number of deduplicated eligible package/from/to review tuples.
          minimum: 0
          type: integer
        not_assessed:
          description: Eligible tuples whose assessment did not run.
          minimum: 0
          type: integer
        omitted:
          description: Assessed tuples omitted for the encoded result limit.
          minimum: 0
          type: integer
        returned:
          description: Completed tuples with returned evidence.
          minimum: 0
          type: integer
        unavailable:
          description: Tuples whose provider evidence failed.
          minimum: 0
          type: integer
      required:
        - eligible
        - completed
        - returned
        - not_assessed
        - unavailable
        - omitted
      type: object
    DependencyDiffReview:
      description: >-
        Dependency diff Review contract; response evidence remains
        producer-owned.
      properties:
        current_version:
          description: Exact base artifact version under review.
          type: string
        data:
          description: Unmodified producer evidence for this section.
          type: object
        declaration_change_ids:
          description: All declaration changes referring to this deduplicated review.
          items:
            type: string
          type: array
        failure:
          $ref: '#/components/schemas/DependencyDiffReviewFailure'
        id:
          description: Opaque side-local evidence identity; never compare IDs across sides.
          type: string
        name:
          description: Package identity supplied by the producer.
          type: string
        reason:
          description: >-
            Concrete reason for unavailable, unassessed or omitted evidence;
            null when absent.
          type:
            - string
            - 'null'
        registry:
          description: Producer registry identity; response vocabulary is open.
          type: string
        source_keys:
          description: All source contexts referring to this deduplicated review.
          items:
            type: string
          type: array
        status:
          description: >-
            Producer evidence status; unfamiliar values must not be interpreted
            as pass or safe.
          type: string
        target_version:
          description: Exact head artifact version under review.
          type: string
      required:
        - id
        - registry
        - name
        - current_version
        - target_version
        - declaration_change_ids
        - source_keys
        - status
        - reason
      type: object
    DependencyDiffBinding:
      description: >-
        Dependency diff Binding contract; response evidence remains
        producer-owned.
      properties:
        agreement_status:
          description: >-
            Current selector-agreement status, separate from the recorded pin
            binding. An opaque tag can have an exact recorded_root_request
            binding without resolving its current value. source_mismatch records
            an independently known Git source contradiction; source_unavailable
            retains unavailable captured Git context without claiming a binding.
            Status vocabulary is open.
          type: string
        basis:
          description: >-
            manifest_lock_agreement, mix_source_lock_agreement,
            resolver_direct_request or recorded_root_request.
            mix_source_lock_agreement identifies static Mix Git source agreement
            without a registry coordinate or checked package version.
            recorded_root_request requires an exact native owner/target edge and
            identical authored request; no mutable tag or name-only inference.
            Basis vocabulary is open; unfamiliar values do not establish a
            checked registry identity.
          type: string
        candidate_ids:
          description: Candidate occurrence IDs; ambiguity remains explicit.
          items:
            type: string
          type: array
        declaration_id:
          description: ID of the declaration in the same snapshot.
          type: string
        declaring_manifest:
          description: Manifest that authored the dependency declaration.
          type: string
        locked_versions:
          description: Recorded concrete versions from the associated source.
          items:
            type: string
          type: array
        matched_versions:
          description: Versions with current selector-agreement evidence.
          items:
            type: string
          type: array
        package:
          description: >-
            A checked registry package identity, or null for a source-only
            binding such as Mix Git. Source-only bindings retain their target
            occurrence and declaration context without a registry
            package-version claim.
          oneOf:
            - $ref: '#/components/schemas/DependencyDiffPackage'
            - type: 'null'
        reasons:
          description: >-
            Producer-authored declaration agreement or resolver-link failure
            causes for this exact binding.
          items:
            $ref: '#/components/schemas/DependencyDiffCause'
          type: array
        review_target:
          $ref: '#/components/schemas/DependencyDiffTarget'
          description: Eligible exact artifact coordinate used for direct review.
        source_id:
          description: ID of the associated source in the same snapshot.
          type: string
        source_key:
          description: Repository-relative source key for this evidence.
          type: string
        status:
          description: >-
            Producer evidence status; unfamiliar values must not be interpreted
            as pass or safe.
          type: string
        target_ids:
          description: Exactly bound occurrence IDs in the same snapshot.
          items:
            type: string
          type: array
      required:
        - declaration_id
        - source_id
        - source_key
        - declaring_manifest
        - status
        - package
        - candidate_ids
        - target_ids
        - locked_versions
        - matched_versions
        - basis
      type: object
    DependencyDiffDeclaration:
      description: >-
        Dependency diff Declaration contract; response evidence remains
        producer-owned.
      properties:
        context:
          description: Producer native context preserving qualified associations.
          type: object
        declared_name:
          description: Literal authored dependency name or alias.
          type: string
        declaring_manifest:
          description: Manifest that authored the dependency declaration.
          type: string
        id:
          description: Opaque side-local evidence identity; never compare IDs across sides.
          type: string
        match_key:
          description: >-
            Producer semantic declaration comparison key, excluding side-local
            IDs.
          items:
            oneOf:
              - type: object
              - type: array
              - type: string
              - type: number
              - type: boolean
              - type: 'null'
          type: array
        package:
          description: >-
            Canonical package identity, distinct from authored alias or
            capability.
          oneOf:
            - $ref: '#/components/schemas/DependencyDiffPackage'
            - type: 'null'
        requirement:
          description: Authored requirement status and text.
          properties:
            status:
              description: >-
                Producer evidence status; unfamiliar values must not be
                interpreted as pass or safe.
              type: string
            text:
              description: Producer text evidence.
              type:
                - string
                - 'null'
          required:
            - status
            - text
          type: object
        requirement_owner:
          description: Manifest that owns an inherited requirement.
          type: string
        source_type:
          description: Native dependency origin classification.
          type: string
      required:
        - id
        - match_key
        - declaring_manifest
        - requirement_owner
        - declared_name
        - package
        - source_type
        - requirement
        - context
      type: object
    DependencyDiffOccurrence:
      description: >-
        Dependency diff Occurrence contract; response evidence remains
        producer-owned.
      properties:
        context:
          description: Producer native context preserving qualified associations.
          type: object
        coordinate:
          description: >-
            Exact registry/name/version coordinate, or null for an ineligible
            identity.
          oneOf:
            - $ref: '#/components/schemas/AuditCoordinate'
            - type: 'null'
        directness:
          description: >-
            Direct, transitive or unknown according to native
            binding/reachability proof.
          type: string
        directness_proof_ids:
          description: >-
            Exact same-side incomplete reachability proof IDs qualifying unknown
            directness. Empty for known directness. An affected leaf can
            reference a proof whose cause names another declaration. Never
            attach unrelated source gaps.
          items:
            type: string
          type: array
        directness_reasons:
          description: >-
            Local causes for unknown directness, including absent root
            association or an unproved recorded root path. Empty for known
            directness. New schema-v1 field; older results may omit it.
          items:
            $ref: '#/components/schemas/DependencyDiffCause'
          type: array
        exposures:
          description: Qualified source and advisory exposure evidence.
          items:
            $ref: '#/components/schemas/DependencyDiffExposure'
          type: array
        id:
          description: Opaque side-local evidence identity; never compare IDs across sides.
          type: string
        locations:
          description: >-
            Screened published source locations; uploaded locators are never
            fetched.
          items:
            type: object
          type: array
        native_id:
          description: Opaque native occurrence identity retained for evidence joins.
          type: string
        ownership:
          description: >-
            Recorded dependency evidence is distinct from proven effective
            ownership.
          type: string
        package:
          $ref: '#/components/schemas/DependencyDiffPackage'
          description: >-
            Canonical package identity, distinct from authored alias or
            capability.
        source_id:
          description: ID of the associated source in the same snapshot.
          type: string
        source_key:
          description: Repository-relative source key for this evidence.
          type: string
        unit_key:
          description: Producer semantic resolution-unit key.
          items:
            type: string
          type: array
        version:
          description: Recorded occurrence version; null when unavailable.
          type:
            - string
            - 'null'
      required:
        - id
        - native_id
        - source_id
        - source_key
        - unit_key
        - ownership
        - package
        - coordinate
        - version
        - context
        - locations
        - directness
        - exposures
      type: object
    DependencyDiffReachability:
      description: >-
        Root proof for this exact manifest/source, independent of other
        lockfiles. Incomplete proof causes live here once; occurrence
        directness_proof_ids and exposure reachability_id join to id in the same
        snapshot. Fields added to schema v1 may be absent in older results.
      properties:
        basis:
          description: >-
            Producer-owned evidence basis. Vocabulary is open; preserve
            unfamiliar future values.
          type: string
        complete:
          description: >-
            Whether the producer established complete dependency reachability
            proof for this root.
          type: boolean
        graph_reasons:
          description: >-
            Independent graph qualifications. complete describes the manifest
            direct-list/binding proof, not all outgoing lists of its
            descendants. git_dependency_graph_unavailable preserves missing Git
            adjacency without inventing a path to an unrooted occurrence. Reason
            vocabulary is open; unfamiliar values do not establish complete
            graph evidence.
          items:
            type: string
          type: array
        id:
          description: >-
            Opaque root proof identifier; occurrence and exposure references
            join only within this snapshot.
          type: string
        manifest_path:
          description: Manifest owning this exact root proof.
          type: string
        reasons:
          description: >-
            Producer-authored causes for incomplete root proof, stored once on
            this proof.
          items:
            $ref: '#/components/schemas/DependencyDiffCause'
          type: array
        source_key:
          description: Exact source key qualified by this root proof.
          type: string
      type: object
    DependencyDiffSource:
      description: >-
        Dependency diff Source contract; response evidence remains
        producer-owned.
      properties:
        format:
          description: Native file format; response vocabulary is open.
          type: string
        id:
          description: Opaque side-local evidence identity; never compare IDs across sides.
          type: string
        inventory_status:
          description: >-
            Completeness of this source inventory, independent of other
            sections.
          type: string
        kind:
          description: Producer evidence kind; response vocabulary is open.
          type: string
        manifest_paths:
          description: Selected manifests associated with this source or unit.
          items:
            type: string
          type: array
        owner_manifest:
          description: >-
            Proven owning manifest, or null when no such ownership is
            established.
          type:
            - string
            - 'null'
        ownership:
          description: >-
            Recorded dependency evidence is distinct from proven effective
            ownership.
          type: string
        ownership_basis:
          description: >-
            Evidence basis: recorded_lockfile establishes recorded dependencies;
            cargo_workspace_root additionally proves effective/auxiliary Cargo
            ownership. Ordinary recorded locks do not claim active-manager
            authority or create an unknown result.
          type: string
        path:
          description: Repository-relative path within the selected input.
          type: string
        unit_key:
          description: Producer semantic resolution-unit key.
          items:
            type: string
          type: array
      required:
        - id
        - path
        - kind
        - format
        - manifest_paths
        - inventory_status
        - ownership
        - owner_manifest
        - ownership_basis
        - unit_key
      type: object
    AuditRegistry:
      description: >-
        Producer-defined value. Open response vocabulary; clients must accept
        unfamiliar values.
      type: string
    AuditDuplicateVersion:
      additionalProperties: true
      properties:
        occurrence_ids:
          description: >-
            Identifiers in occurrences[].id for this version in the combined
            upload.
          items:
            type: string
          type: array
        version:
          description: One distinct version within the duplicate registry/name group.
          type: string
      required:
        - version
        - occurrence_ids
      type: object
    AuditResolutionDiagnostic:
      additionalProperties: true
      properties:
        name:
          description: Dependency name associated with the manifest resolution diagnostic.
          type: string
        reason:
          description: >-
            Producer reason why resolution could not fully establish this
            dependency. Open response vocabulary; clients must accept unfamiliar
            values.
          type: string
      required:
        - name
        - reason
      type: object
    AuditUnattributedRequirement:
      additionalProperties: true
      description: >-
        Relevant same-registry/name declaration with no asserted resolved
        target. It is not attributed to any duplicate version; absent means the
        recorded edge explicitly lacks a target. Manifest/lockfile association
        only bounds relevance.
      properties:
        path:
          description: Input filename locating this evidence.
          type: string
        requested_requirement:
          description: >-
            Literal recorded version/tag requirement, or null when not recorded
            or withheld.
          type:
            - string
            - 'null'
        requester:
          $ref: '#/components/schemas/AuditRequester'
          description: >-
            Recorded requesting package or root label; selects no resolved
            target.
        requirement_status:
          description: >-
            Currently recorded, not_recorded, withheld. Open response
            vocabulary; clients must accept unfamiliar values.
          type: string
        target_status:
          description: >-
            Currently untargeted, absent. Open response vocabulary; clients must
            accept unfamiliar values.
          type: string
      required:
        - path
        - requester
        - requested_requirement
        - requirement_status
        - target_status
      type: object
    AuditDuplicateVersionV2:
      additionalProperties: true
      properties:
        origins:
          description: >-
            Requesting origins for this exact version, including an explicit
            absence for any source path without parent evidence.
          items:
            $ref: '#/components/schemas/AuditRequirementOrigin'
          type: array
        paths:
          description: >-
            Sorted unique input paths locating this evidence; file association
            is not package reachability.
          items:
            type: string
          type: array
        version:
          description: One distinct version within the duplicate registry/name group.
          type: string
      required:
        - version
        - paths
        - origins
      type: object
    AuditRemediationBlocker:
      additionalProperties: true
      properties:
        dependency_name:
          description: >-
            Dependency named by this request, distinct from its requesting owner
            and possibly from a recommended subject. Bound declarations retain
            authored aliases and capabilities; Maven uses group:artifact. Other
            requests use their recorded name or represented target identity.
            Older retained reports and unnamed trace requests may omit this
            field.
          type: string
      type: object
    AuditRemediationRequestCheck:
      additionalProperties: true
      description: >-
        A source-local set of screened requests evaluated against one canonical
        target. dependency_name retains the authored dependency spelling; target
        identifies the resolved registry coordinate.
      properties:
        clauses:
          description: >-
            Nonempty screened request clauses with membership, participation and
            parent-support evidence. Recorded conditions do not establish active
            context.
          items:
            additionalProperties: true
            properties:
              binding:
                description: ' Open producer vocabulary; accept unfamiliar values. Known values: bound, possible.'
                type: string
              capture:
                description: ' Open producer vocabulary; accept unfamiliar values. Known values: complete, filtered, unavailable.'
                type: string
              conditions:
                items:
                  additionalProperties: true
                  properties:
                    expression:
                      type:
                        - string
                        - 'null'
                    kind:
                      type: string
                    status:
                      description: ' Open producer vocabulary; accept unfamiliar values. Known values: captured, filtered, unavailable.'
                      type: string
                  required:
                    - kind
                    - status
                    - expression
                  type: object
                type: array
              declaration_capture:
                description: ' Open producer vocabulary; accept unfamiliar values. Known values: complete, incomplete, unavailable.'
                type: string
              effective_membership:
                $ref: '#/components/schemas/AuditRemediationMembership'
              membership_policy:
                description: ' Open producer vocabulary; accept unfamiliar values. Known values: not_needed, established, unestablished.'
                type: string
              ordinal:
                anyOf:
                  - minimum: 0
                    type: integer
                  - type: 'null'
              parent_support:
                anyOf:
                  - additionalProperties: true
                    properties:
                      status:
                        description: ' Open producer vocabulary; accept unfamiliar values. Known values: not_observed, unobserved, absent.'
                        type: string
                    required:
                      - status
                    type: object
                  - additionalProperties: true
                    properties:
                      selector:
                        type: string
                      status:
                        description: ' Open producer vocabulary; accept unfamiliar values. Known values: present.'
                        type: string
                    required:
                      - status
                      - selector
                    type: object
                  - additionalProperties: true
                    properties:
                      reason:
                        type: string
                      status:
                        description: ' Open producer vocabulary; accept unfamiliar values. Known values: invalid.'
                        type: string
                    required:
                      - status
                      - reason
                    type: object
              participation:
                additionalProperties: true
                properties:
                  original_observed:
                    type: boolean
                  rule:
                    type: string
                  scope:
                    additionalProperties: true
                    properties:
                      conflicts_present:
                        type: boolean
                      format:
                        type:
                          - string
                          - 'null'
                      group_capture:
                        description: ' Open producer vocabulary; accept unfamiliar values. Known values: available, unavailable.'
                        type: string
                      group_refs:
                        items:
                          type: integer
                        type: array
                      original_requester_markers:
                        description: >-
                          Literal recorded marker selectors for original
                          occurrences, not active context or replacement-release
                          predicates. Omission makes no absence claim.
                        items:
                          type: string
                        type: array
                      original_target_markers:
                        description: >-
                          Literal recorded marker selectors for original
                          occurrences, not active context or replacement-release
                          predicates. Omission makes no absence claim.
                        items:
                          type: string
                        type: array
                      path:
                        type: string
                      root_project:
                        type: boolean
                      workspace_member:
                        type: boolean
                    type: object
                  status:
                    description: ' Open producer vocabulary; accept unfamiliar values. Known values: required, conditional, unestablished.'
                    type: string
                required:
                  - status
                  - rule
                  - scope
                  - original_observed
                type: object
              raw_membership:
                $ref: '#/components/schemas/AuditRemediationMembership'
              request:
                $ref: '#/components/schemas/AuditRemediationRequest'
              witness_role:
                description: ' Open producer vocabulary; accept unfamiliar values. Known values: decisive_conflict, subsumed, conditional, possible, comparison.'
                type: string
            required:
              - request
              - ordinal
              - binding
              - capture
              - declaration_capture
              - membership_policy
              - witness_role
              - conditions
              - raw_membership
              - effective_membership
              - participation
              - parent_support
            type: object
          minItems: 1
          type: array
        dependency_name:
          description: >-
            Authored dependency spelling, nullable when unnamed; distinct from
            the optional non-nullable dependency_name on request and blocker
            evidence.
          type:
            - string
            - 'null'
        owner:
          additionalProperties: true
          description: >-
            Requesting owner for this source-local set of clauses, distinct from
            the authored dependency and target coordinate.
          properties:
            name:
              type: string
            version:
              anyOf:
                - type: string
                - type: 'null'
          required:
            - name
            - version
          type: object
        path:
          description: >-
            Input path carrying the screened requests evaluated against this
            target.
          type: string
        result:
          description: ' Open producer vocabulary; accept unfamiliar values. Known values: matched, blocked, unchecked, preference_differs.'
          type: string
        target:
          $ref: '#/components/schemas/AuditCoordinate'
      required:
        - owner
        - path
        - dependency_name
        - target
        - result
        - clauses
      type: object
    AuditRemediationSearchDetail:
      anyOf:
        - additionalProperties: true
          description: >-
            An unavailable answer during this subject search, including losing
            alternatives. operation identifies the missing answer; reasons are
            producer facts, never reconstructed from limitation strings. Witness
            requirements depend on operation: source has coordinate and
            source/boundary/status; catalog has package; release has
            coordinate/acquisition; inventory has coordinate/source/coverage;
            boundary has boundary or coordinate/source and declarations or
            policy/context; request has boundary and request/qualification or
            status; membership has request_checks/changed_ancestors/boundary;
            advisories has status and coordinate or current/target; ordering has
            current/target/status; maven_policy has coordinate/source/policy.
          properties:
            kind:
              description: ' Open producer vocabulary; accept unfamiliar values. Known values: unavailable.'
              type: string
            operation:
              description: ' Open producer vocabulary; accept unfamiliar values. Known values: source, catalog, release, inventory, boundary, request, membership, advisories, ordering, maven_policy.'
              type: string
            reasons:
              items:
                type: string
              minItems: 1
              type: array
            witness:
              $ref: '#/components/schemas/AuditRemediationSearchWitness'
          required:
            - kind
            - operation
            - reasons
            - witness
          type: object
        - additionalProperties: true
          description: >-
            Observed work stop with a coordinate (nullable when unavailable) and
            local/shared budget scope. used and allowed are present together
            only for observed counts; deadline stops do not invent counts.
            Neither form describes the selected action checks.
          properties:
            allowed:
              minimum: 1
              type: integer
            kind:
              description: ' Open producer vocabulary; accept unfamiliar values. Known values: stopped.'
              type: string
            reason:
              type: string
            stage:
              description: ' Open producer vocabulary; accept unfamiliar values. Known values: leaf_evaluation, domain_construction, domain_sampling, domain_reservation, seed_admission, frontier_admission, parent_evaluation.'
              type: string
            used:
              minimum: 0
              type: integer
            witness:
              allOf:
                - $ref: '#/components/schemas/AuditRemediationSearchWitness'
                - required:
                    - coordinate
                    - budget_scope
                  type: object
          required:
            - kind
            - stage
            - reason
            - witness
          type: object
      description: >-
        Whole-search obstacles independent of selected-action checks and trace
        retention. Two producer forms: unavailable and stopped. Unknown
        operation/stage/reason vocabulary stays informational. Unfamiliar
        vocabulary is accepted within these structural forms; a structurally new
        form requires contract adoption. Runtime transports original evidence
        without interpreting this union.
    AuditRemediationRelation:
      additionalProperties: true
      description: Retained source-local relation evidence with screened authored requests.
      properties:
        requests:
          description: >-
            Screened requests on this source-local relation. Authored dependency
            names remain distinct from requesting owners and may be absent in
            older reports or unnamed observations.
          items:
            $ref: '#/components/schemas/AuditRemediationRequest'
          type: array
      type: object
    AuditLifecycleObservation:
      additionalProperties: true
      description: >-
        Distinct native authority observation. observed_at is acquisition time,
        not status-change time or freshness certification. Replacement is
        publisher advice, never an upgrade recommendation.
      properties:
        affected:
          description: >-
            Exact selected coordinates and sorted input paths supported by this
            observation.
          items:
            $ref: '#/components/schemas/AuditLifecycleReference'
          type: array
        observed_at:
          description: >-
            Acquisition time when retained; neither status-change time nor proof
            of freshness.
          format: date-time
          type:
            - string
            - 'null'
        reason:
          description: >-
            Normalized native publisher reason when supplied; null when
            unavailable.
          type:
            - string
            - 'null'
        reason_codes:
          description: >-
            Open native publisher reason codes; retained without gateway
            interpretation.
          items:
            type: string
          type: array
        replacement:
          description: >-
            Optional publisher-suggested package name, not a resolved upgrade
            recommendation.
          type:
            - string
            - 'null'
        source_version:
          description: >-
            Version supplying this observation; it can differ from the selected
            or affected release.
          type:
            - string
            - 'null'
      required:
        - source_version
        - observed_at
        - reason
        - replacement
        - reason_codes
        - affected
      type: object
    DependencyDiffTarget:
      description: >-
        Dependency diff Target contract; response evidence remains
        producer-owned.
      properties:
        package:
          $ref: '#/components/schemas/DependencyDiffPackage'
          description: >-
            Canonical package identity, distinct from authored alias or
            capability.
        version:
          description: Recorded occurrence version; null when unavailable.
          minLength: 1
          type: string
      required:
        - package
        - version
      type:
        - object
        - 'null'
    DependencyDiffReviewFailure:
      description: >-
        Safe fixed classification of a Task exit. scope distinguishes an
        individual review from batch collection/result encoding; batch failure
        does not prove package assessment failed. No raw exception values,
        messages, stack traces or arbitrary exit payloads are exposed. Codes and
        scope are extensible.
      properties:
        code:
          description: >-
            Safe producer failure classification. Vocabulary is open; preserve
            unfamiliar future values.
          type: string
        message:
          description: >-
            Fixed safe producer explanation without raw exception values, module
            names, stacks or exit payloads.
          type: string
        scope:
          description: >-
            Producer failure scope, currently review or batch. Vocabulary is
            open; preserve unfamiliar future values. A batch collection or
            encoding failure does not establish package assessment failure.
          type: string
      required:
        - scope
        - code
        - message
      type: object
    DependencyDiffCause:
      description: >-
        Producer-owned explanation with same-snapshot associations. When
        declaration_id is present, dependency_name names the authored
        declaration blocking proof; occurrence-local root-association/path
        causes instead name the affected occurrence package when available. Root
        dependency coverage fields apply to lock or resolver sources. Codes are
        extensible; preserve unknown values.
      properties:
        code:
          description: >-
            Producer-owned cause code. Vocabulary is open; preserve unfamiliar
            future values.
          type: string
        coverage_reasons:
          description: >-
            Dependency coverage reason strings for this exact lock or resolver
            root source. Vocabulary is open; preserve unfamiliar future values.
          items:
            type: string
          type: array
        coverage_state:
          description: >-
            Dependency coverage state for this exact lock or resolver root
            source. Vocabulary is open; preserve unfamiliar future values.
          type: string
        declaration_id:
          description: >-
            Associated authored declaration ID in the same snapshot side, when
            known.
          type: string
        dependency_name:
          description: >-
            When declaration_id is present, names the authored declaration
            blocking proof, which can differ from the affected occurrence. Local
            root-association/path causes instead name the affected occurrence
            package when available; can be null.
          type:
            - string
            - 'null'
        manifest_path:
          description: Associated project-relative manifest path, when known.
          type: string
        message:
          description: Plain producer-authored explanation for this cause.
          type: string
        source_key:
          description: >-
            Exact source key associated with this cause in the same snapshot
            side.
          type: string
      required:
        - code
        - message
        - source_key
      type: object
    DependencyDiffExposure:
      description: >-
        Root-qualified directness exposure for one associated manifest.
        Properties may be absent in older open-object schema-v1 results.
      properties:
        basis:
          description: >-
            Producer-owned evidence basis. Vocabulary is open; preserve
            unfamiliar future values.
          type: string
        directness:
          description: >-
            Producer directness of this exact exposure. Vocabulary is open;
            preserve unfamiliar future values.
          type: string
        manifest_path:
          description: Manifest root associated with this occurrence exposure.
          type: string
        reachability_id:
          description: >-
            Exact same-side root proof. Unknown exposure references its failed
            proof; consumers do not infer graph causes.
          type: string
      type: object
    AuditRequester:
      additionalProperties: true
      description: >-
        Requesting package or root label as recorded in the source. A null
        version means the source did not record it.
      properties:
        name:
          description: Recorded requesting package or root name.
          type: string
        version:
          description: Recorded version; null when the source did not record one.
          type:
            - string
            - 'null'
      required:
        - name
        - version
      type: object
    AuditRequirementOrigin:
      additionalProperties: true
      description: >-
        Parent evidence for this exact resolved version. recorded preserves a
        version/tag-shaped requirement literally; it does not assert
        satisfaction or incompatibility. Cargo edges do not retain ranges.
        Source locators and unsupported requirement text are withheld
        value-free. Direct resolver roots use a unique declaration matched by
        source path and package identity; multiple matching declarations yield
        requirement_ambiguous.
      properties:
        path:
          description: Input filename locating this evidence.
          type: string
        requested_requirement:
          description: >-
            Literal recorded version/tag requirement, or null when unavailable,
            withheld or ambiguous. It does not assert satisfaction or conflict.
          type:
            - string
            - 'null'
        requester:
          description: >-
            Requesting package or root label, or null when no supported parent
            was recorded.
          oneOf:
            - $ref: '#/components/schemas/AuditRequester'
            - type: 'null'
        status:
          description: >-
            Currently recorded, requirement_not_recorded, requirement_withheld,
            requirement_ambiguous, parent_not_recorded. Open response
            vocabulary; clients must accept unfamiliar values.
          type: string
      required:
        - path
        - requester
        - requested_requirement
        - status
      type: object
    AuditRemediationMembership:
      anyOf:
        - additionalProperties: true
          properties:
            status:
              description: ' Open producer vocabulary; accept unfamiliar values. Known values: matched, mismatched.'
              type: string
            strength:
              description: ' Open producer vocabulary; accept unfamiliar values. Known values: required, preference.'
              type: string
          required:
            - status
            - strength
          type: object
        - additionalProperties: true
          properties:
            reason:
              type: string
            status:
              description: ' Open producer vocabulary; accept unfamiliar values. Known values: unchecked.'
              type: string
          required:
            - status
            - reason
          type: object
      description: >-
        A raw or effective membership result: matched or mismatched with
        strength, or unchecked with a reason. Open status vocabulary is accepted
        within either structural form; a structurally new form requires contract
        adoption.
    AuditRemediationRequest:
      additionalProperties: true
      description: >-
        Screened native request evidence. Source locators are withheld.
        Applicability is not inferred from version membership. Older immutable
        reports and unnamed observations may omit dependency_name.
      properties:
        basis:
          description: ' Open producer vocabulary; accept unfamiliar values. Known values: manifest, lockfile, resolver, exact_parent.'
          type: string
        context:
          additionalProperties: true
          description: >-
            Screened request context. Provider-bound capability evidence may
            remain here while requested_requirement is null; context does not
            establish active conditions.
          type: object
        declaration_ref:
          anyOf:
            - additionalProperties: true
              properties:
                index:
                  minimum: 0
                  type: integer
                kind:
                  description: ' Open producer vocabulary; accept unfamiliar values. Known values: native, legacy.'
                  type: string
                path:
                  type: string
              required:
                - path
                - kind
                - index
              type: object
            - type: 'null'
          description: >-
            Nullable source-local declaration reference. Its path, native/legacy
            kind and index locate the represented declaration.
        dependency_name:
          description: >-
            Dependency named by this request, distinct from its requesting owner
            and possibly from a recommended subject. Bound declarations retain
            authored aliases and capabilities; Maven uses group:artifact. Other
            requests use their recorded name or represented target identity.
            Older retained reports and unnamed trace requests may omit this
            field.
          type: string
        kind:
          description: >-
            Recorded dependency declaration kind, retained as an open producer
            string.
          type: string
        owner:
          additionalProperties: true
          description: >-
            Requesting owner, with name and nullable version; distinct from the
            authored dependency and recommended subject.
          properties:
            name:
              type: string
            version:
              anyOf:
                - type: string
                - type: 'null'
          required:
            - name
            - version
          type: object
        owner_role:
          description: ' Open producer vocabulary; accept unfamiliar values. Known values: project, third_party, unknown.'
          type: string
        path:
          description: Input path carrying this source-local request.
          type: string
        requested_requirement:
          anyOf:
            - type: string
            - type: 'null'
          description: >-
            Screened direct-owner version request. Provider-bound requests use
            null and provider_requirement status; their original capability
            name, request and screening status stay in context.request. Current
            lock proof cannot certify another release capability.
        requirement_status:
          description: ' Open producer vocabulary; accept unfamiliar values. Known values: recorded, not_recorded, withheld, ambiguous, provider_requirement.'
          type: string
      required:
        - owner
        - owner_role
        - path
        - kind
        - requested_requirement
        - requirement_status
        - basis
        - context
        - declaration_ref
      type: object
    AuditRemediationSearchWitness:
      additionalProperties: true
      description: >-
        Screened producer facts for one unavailable answer or observed work
        stop. Fields depend on the operation and scope; absence carries no
        inferred causal story.
      properties:
        acquisition:
          description: ' Open producer vocabulary; accept unfamiliar values. Known values: lookup_limit, phase_deadline, release_row_unavailable, release_row_unsuitable, lookup_failed, chunk_task_timeout.'
          type: string
        boundary:
          additionalProperties: true
          description: >-
            From/to source witnesses locating the represented dependency
            boundary; no complete graph or native-resolution claim.
          properties:
            from:
              $ref: '#/components/schemas/AuditRemediationSearchSource'
            to:
              $ref: '#/components/schemas/AuditRemediationSearchSource'
          required:
            - from
            - to
          type: object
        budget_scope:
          description: ' Open producer vocabulary; accept unfamiliar values. Known values: local, shared.'
          type: string
        changed_ancestors:
          description: >-
            Screened source witnesses for ancestors changed in this search
            alternative.
          items:
            $ref: '#/components/schemas/AuditRemediationSearchSource'
          type: array
        context:
          additionalProperties: true
          description: >-
            Screened Maven scope and exclusion context retained for this answer;
            it does not imply resolution or feature activation.
          properties:
            exclusions:
              items:
                additionalProperties: true
                properties:
                  artifact_id:
                    type: string
                  group_id:
                    type: string
                required:
                  - group_id
                  - artifact_id
                type: object
              type: array
            expandable:
              type: boolean
            maven_scope:
              type:
                - string
                - 'null'
            previous_exclusions:
              items:
                additionalProperties: true
                properties:
                  artifact_id:
                    type: string
                  group_id:
                    type: string
                required:
                  - group_id
                  - artifact_id
                type: object
              type: array
            previously_expandable:
              type: boolean
          type: object
        coordinate:
          anyOf:
            - $ref: '#/components/schemas/AuditCoordinate'
            - type: 'null'
          description: >-
            Nullable coordinate scoped by this answer or stop; null makes no
            coordinate claim.
        coverage:
          additionalProperties: true
          description: >-
            Observed dependency-inventory presence, completeness and reasons for
            this answer; incomplete coverage is not a solver conclusion.
          properties:
            complete:
              type: boolean
            reasons:
              items:
                type: string
              type: array
            status:
              description: ' Open producer vocabulary; accept unfamiliar values. Known values: missing, present.'
              type: string
          required:
            - status
            - reasons
          type: object
        current:
          $ref: '#/components/schemas/AuditCoordinate'
          description: Current coordinate used in the observed search comparison.
        declarations:
          description: >-
            Screened dependency declaration names, requests, capture statuses
            and scopes relevant to this answer.
          items:
            additionalProperties: true
            properties:
              name:
                type: string
              requested_requirement:
                type:
                  - string
                  - 'null'
              requirement_status:
                type: string
              scope:
                type: string
            required:
              - name
              - requested_requirement
              - requirement_status
              - scope
            type: object
          type: array
        eligible:
          description: >-
            Producer-reported eligible item count for this operation or stage;
            the producer determines the counting unit.
          minimum: 0
          type: integer
        observation:
          additionalProperties: true
          description: >-
            Recorded source-local dependency request observation and capture
            status.
          properties:
            declaration_path:
              type:
                - string
                - 'null'
            declared_scope:
              type:
                - string
                - 'null'
            name:
              type: string
            path:
              type: string
            recorded_scopes:
              items:
                type: string
              type: array
            requested_requirement:
              type:
                - string
                - 'null'
            requirement_status:
              type: string
            status:
              type: string
          required:
            - status
            - path
            - name
            - requested_requirement
            - requirement_status
          type: object
        package:
          additionalProperties: true
          description: >-
            Registry and package identity associated with the unavailable
            catalog answer.
          properties:
            name:
              type: string
            registry:
              $ref: '#/components/schemas/AuditRegistry'
          required:
            - registry
            - name
          type: object
        paths:
          description: Input paths retained by the producer for this search obstacle.
          items:
            type: string
          type: array
        policy:
          additionalProperties: true
          description: >-
            Screened Maven dependency policy, origins and diagnostics relevant
            to this search answer.
          properties:
            classifier:
              type:
                - string
                - 'null'
            diagnostics:
              items:
                additionalProperties: true
                properties:
                  code:
                    type: string
                  field:
                    type: string
                required:
                  - code
                  - field
                type: object
              type: array
            effective_requirement:
              type:
                - string
                - 'null'
            effective_requirement_status:
              type: string
            effective_scope:
              type:
                - string
                - 'null'
            expandable:
              type: boolean
            maven_scope:
              type:
                - string
                - 'null'
            name:
              type: string
            optional:
              type:
                - boolean
                - 'null'
            origins:
              items:
                additionalProperties: true
                properties:
                  index:
                    minimum: 0
                    type: integer
                  manifest_path:
                    type: string
                  section:
                    type: string
                required:
                  - manifest_path
                  - section
                  - index
                type: object
              type: array
            requested_requirement:
              type:
                - string
                - 'null'
            requirement_status:
              type: string
            type:
              type:
                - string
                - 'null'
            version_managed:
              type: boolean
          required:
            - name
            - requested_requirement
            - requirement_status
            - effective_requirement
            - effective_requirement_status
            - type
            - classifier
            - maven_scope
            - optional
            - effective_scope
            - expandable
            - version_managed
            - origins
            - diagnostics
          type: object
        qualification:
          additionalProperties: true
          description: >-
            Recorded binding, capture, membership-policy and participation
            qualification. Conditions are retained evidence, not inferred active
            context.
          properties:
            binding:
              description: ' Open producer vocabulary; accept unfamiliar values. Known values: bound, possible.'
              type: string
            capture:
              description: ' Open producer vocabulary; accept unfamiliar values. Known values: complete, filtered, unavailable.'
              type: string
            conditions:
              items:
                additionalProperties: true
                properties:
                  expression:
                    type:
                      - string
                      - 'null'
                  kind:
                    type: string
                  status:
                    description: ' Open producer vocabulary; accept unfamiliar values. Known values: captured, filtered, unavailable.'
                    type: string
                required:
                  - kind
                  - status
                  - expression
                type: object
              type: array
            declaration_capture:
              description: ' Open producer vocabulary; accept unfamiliar values. Known values: complete, incomplete, unavailable.'
              type: string
            membership_policy:
              description: ' Open producer vocabulary; accept unfamiliar values. Known values: not_needed, established, unestablished.'
              type: string
            participation:
              description: ' Open producer vocabulary; accept unfamiliar values. Known values: required, conditional, unestablished.'
              type: string
            policy_reasons:
              items:
                type: string
              type: array
            rule:
              type: string
            scope:
              additionalProperties: true
              properties:
                conflicts_present:
                  type: boolean
                format:
                  type:
                    - string
                    - 'null'
                group_capture:
                  description: ' Open producer vocabulary; accept unfamiliar values. Known values: available, unavailable.'
                  type: string
                group_refs:
                  items:
                    type: integer
                  type: array
                original_requester_markers:
                  description: >-
                    Literal recorded marker selectors for original occurrences,
                    not active context or replacement-release predicates.
                    Omission makes no absence claim.
                  items:
                    type: string
                  type: array
                original_target_markers:
                  description: >-
                    Literal recorded marker selectors for original occurrences,
                    not active context or replacement-release predicates.
                    Omission makes no absence claim.
                  items:
                    type: string
                  type: array
                path:
                  type: string
                root_project:
                  type: boolean
                workspace_member:
                  type: boolean
              type: object
          required:
            - binding
            - capture
            - declaration_capture
            - membership_policy
            - conditions
            - policy_reasons
            - participation
            - rule
            - scope
          type: object
        request:
          $ref: '#/components/schemas/AuditRemediationRequest'
          description: >-
            Screened source-local request associated with the unavailable
            answer.
        request_checks:
          description: >-
            Source-local request checks for this search alternative; distinct
            from the recommendation selected-action checks.
          items:
            $ref: '#/components/schemas/AuditRemediationRequestCheck'
          type: array
        requests:
          description: >-
            Screened source-local requests retained for this answer, preserving
            authored identities separately from owners.
          items:
            $ref: '#/components/schemas/AuditRemediationRequest'
          type: array
        retained:
          description: >-
            Producer-reported retained item count for this operation or stage;
            the producer determines the counting unit. Distinct from
            whole-collection search_detail_status.
          minimum: 0
          type: integer
        source:
          $ref: '#/components/schemas/AuditRemediationSearchSource'
          description: >-
            Screened source-local path, coordinate and occurrence references
            associated with this answer.
        status:
          description: >-
            Recorded answer or observation status from an open producer
            vocabulary; unfamiliar values do not imply success.
          type: string
        target:
          $ref: '#/components/schemas/AuditCoordinate'
          description: >-
            Candidate coordinate used in the observed search comparison; it need
            not be the selected action target.
      type: object
    AuditLifecycleReference:
      additionalProperties: true
      description: >-
        Selected exact coordinate and sorted unique input paths. File
        association is not reachability.
      properties:
        coordinate:
          $ref: '#/components/schemas/AuditCoordinate'
        paths:
          description: >-
            Nonempty sorted unique input paths locating the affected coordinate;
            file association does not establish reachability.
          items:
            type: string
          minItems: 1
          type: array
          uniqueItems: true
      required:
        - coordinate
        - paths
      type: object
    AuditRemediationSearchSource:
      additionalProperties: true
      description: >-
        Screened source witness with an input path, nullable coordinate and
        retained occurrence references.
      properties:
        coordinate:
          anyOf:
            - $ref: '#/components/schemas/AuditCoordinate'
            - type: 'null'
        occurrence_refs:
          description: >-
            Nonnegative indexes into retained remediation occurrence evidence
            for this source; these references do not establish complete
            reachability.
          items:
            minimum: 0
            type: integer
          type: array
        path:
          description: Input path locating the source of this search witness.
          type: string
      required:
        - path
        - coordinate
        - occurrence_refs
      type: object
  securitySchemes:
    bearer_auth:
      scheme: bearer
      type: http

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.