Skip to content

docs: add ADRs for Evidence Mapping and Definition#423

Open
jpower432 wants to merge 3 commits into
gemaraproj:mainfrom
jpower432:evidence-mapping
Open

docs: add ADRs for Evidence Mapping and Definition#423
jpower432 wants to merge 3 commits into
gemaraproj:mainfrom
jpower432:evidence-mapping

Conversation

@jpower432

@jpower432 jpower432 commented Jun 16, 2026

Copy link
Copy Markdown
Contributor

Description

Introduced a new ADR for Evidence Mapping, detailing the structure and purpose of the #EvidenceMapping type and corresponding Evidence Type in Layer 3.

Schema Changes

Schema Changes Made

  • No schema changes
  • Audit Log schema (auditlog.cue) changes
  • Capability Catalog schema (capabilitycatalog.cue) changes
  • Control Catalog schema (controlcatalog.cue) changes
  • Enforcement Log schema (enforcementlog.cue) changes
  • Evaluation Log schema (evaluationlog.cue) changes
  • Guidance Catalog schema (guidancecatalog.cue) changes
  • Mapping Document schema (mappingdocument.cue) changes
  • Policy Document schema (policy.cue) changes
  • Principle Catalog schema (principlecatalog.cue) changes
  • Risk Catalog schema (riskcatalog.cue) changes
  • Threat Catalog schema (threatcatalog.cue) changes
  • Vector Catalog schema (vectorcatalog.cue) changes
  • Other

Schema Change Details

<!-- If applicable, provide a brief summary or example of schema changes -->

Testing

  • Unit tests added/updated
  • Manual testing performed
  • Test data updated (if applicable)

Related Issues

Ref: #421

Reviewer Hints


Self-review checklist

  • This PR has content that was created with AI assistance.
  • I have the experience and knowledge necessary to answer maintainer questions about the content of this PR, without using AI.

Introduced a new ADR for Evidence Mapping, detailing the structure and purpose of the #EvidenceMapping type. This replaces the previous #Evidence definition to better capture evidence source references and their integrity.

Assisted-by: Claude (Anthropic, Claude Opus 4.6)
Signed-off-by: Jennifer Power <barnabei.jennifer@gmail.com>
@github-actions github-actions Bot added the documentation Improvements or additions to documentation label Jun 16, 2026
@jpower432 jpower432 linked an issue Jun 25, 2026 that may be closed by this pull request
3 tasks
…finitions)

ADR-0023 introduces #EvidenceMapping for source provenance on #Evidence.
ADR-0024 adds #EvidenceTypeDefinition with validity periods and retypes
frequency as int on #AssessmentPlan. Both moved to Proposed status.

Assisted-by: Claude (Anthropic, Claude Opus 4.6)
Signed-off-by: Jennifer Power <barnabei.jennifer@gmail.com>
@jpower432 jpower432 changed the title docs: add ADR 0023 for Evidence Mapping structure [WIP] docs: add ADRs for Evidence Mapping and Definition Jul 1, 2026
@jpower432 jpower432 requested a review from eddie-knight July 1, 2026 14:18
@jpower432 jpower432 marked this pull request as ready for review July 1, 2026 14:20
@jpower432 jpower432 requested a review from a team as a code owner July 1, 2026 14:20
Signed-off-by: Jennifer Power <barnabei.jennifer@gmail.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[design] where do attestations and evidence fit into the layers?

1 participant