IF Commons GitHub

governance/evidence

Written to: 2 requirements: 2 proved, 0 partly, 0 failing, 0 with no test recorded. 0002-objective-evidence FR-001, 0002-objective-evidence FR-002

The record of evidence against an assessment objective (0002-objective-evidence FR-001, FR-002): which objective of which framework, by which method (examine, interview, test), with what result, by whom (a tool or a person), when, until when it holds, and where it can be looked at. Only a person determines: a tool's record supports an objective and never settles it, as an assessor's methods put it.

import { METHODS } from "./evidence.ts";
METHODS; // ["examine", "interview", "test"]

Source: commons/assessment/src/governance/evidence.ts

2 of 26 exports are imported by a test of the run. A test that imports an export may not call it or check what it returns.

governance.METHODSconstno test imports it
const METHODS: readonly ["examine", "interview", "test"]

The three methods of an assessment of SP 800-53A and SP 800-171A.

governance.Methodtypeno test imports it
type Method = (typeof METHODS)[number];

A method.

governance.RESULTSconstno test imports it
const RESULTS: readonly ["pass", "fail", "not-applicable"]

What the evidence shows of the objective.

governance.Resulttypeno test imports it
type Result = (typeof RESULTS)[number];

A result.

governance.ORIGINSconstno test imports it
const ORIGINS: readonly ["machine", "signed-record", "attestation", "screenshot"]

How the evidence was obtained, which is how much it is worth: read from the system by a tool, a signed record from a system, a person's attestation, or a screenshot.

governance.Origintypeno test imports it
type Origin = (typeof ORIGINS)[number];

An origin.

governance.Bytypeno test imports it
type By = { readonly kind: "tool" | "person"; readonly name: string };

Who made the record: a tool (a probe, a scanner) or a person (an assessor, an owner).

governance.Evidencetypeno test imports it
type Evidence = { readonly id: string; readonly framework: string; readonly objective: string; readonly method: … (862 characters)
type Evidence = {
  readonly id: string;
  readonly framework: string;
  readonly objective: string;
  readonly method: Method;
  readonly result: Result;
  readonly by: By;
  /** When the evidence was gathered (an instant, `2026-11-21T12:00:00Z`). */
  readonly at: string;
  /** Until when it holds (an instant); where it is absent the evidence does not expire. */
  readonly validUntil?: string;
  /** Where the evidence can be looked at: a policy, a file and its digest, an address, a ticket. */
  readonly source: string;
  /** A person's word on it; required for `not-applicable`. */
  readonly note?: string;
  /** How it was obtained; where absent a tool's record is `machine` and a person's is `attestation`. */
  readonly origin?: Origin;
  /** Whether a person determines the objective from it. A tool never does. */
  readonly determines: boolean;
};

One record of evidence.

governance.Objectivetypeno test imports it
type Objective = { readonly id: string; readonly requirement: string; readonly statement: string };

An objective of a framework, as the assessment reads it: its identifier, its requirement and what it asks.

governance.STANDINGSconstno test imports it
const STANDINGS: readonly ["met", "not-met", "not-applicable", "supported", "stale", "no-evidence"]

How one objective stands.

governance.Standingtypeno test imports it
type Standing = (typeof STANDINGS)[number];

A standing.

governance.ROLLUPSconstno test imports it
const ROLLUPS: readonly ["met", "not-met", "not-applicable", "partial", "no-evidence"]

How a requirement stands from its objectives.

governance.Rolluptypeno test imports it
type Rollup = (typeof ROLLUPS)[number];

A roll-up.

METHODSconstno test imports it
const METHODS: readonly ["examine", "interview", "test"]

The three methods of an assessment of SP 800-53A and SP 800-171A.

Methodtypeno test imports it
type Method = (typeof METHODS)[number];

A method.

RESULTSconstno test imports it
const RESULTS: readonly ["pass", "fail", "not-applicable"]

What the evidence shows of the objective.

Resulttypeno test imports it
type Result = (typeof RESULTS)[number];

A result.

ORIGINSconstno test imports it
const ORIGINS: readonly ["machine", "signed-record", "attestation", "screenshot"]

How the evidence was obtained, which is how much it is worth: read from the system by a tool, a signed record from a system, a person's attestation, or a screenshot.

Origintypeno test imports it
type Origin = (typeof ORIGINS)[number];

An origin.

Bytypeno test imports it
type By = { readonly kind: "tool" | "person"; readonly name: string };

Who made the record: a tool (a probe, a scanner) or a person (an assessor, an owner).

Evidencetype
type Evidence = { readonly id: string; readonly framework: string; readonly objective: string; readonly method: … (862 characters)
type Evidence = {
  readonly id: string;
  readonly framework: string;
  readonly objective: string;
  readonly method: Method;
  readonly result: Result;
  readonly by: By;
  /** When the evidence was gathered (an instant, `2026-11-21T12:00:00Z`). */
  readonly at: string;
  /** Until when it holds (an instant); where it is absent the evidence does not expire. */
  readonly validUntil?: string;
  /** Where the evidence can be looked at: a policy, a file and its digest, an address, a ticket. */
  readonly source: string;
  /** A person's word on it; required for `not-applicable`. */
  readonly note?: string;
  /** How it was obtained; where absent a tool's record is `machine` and a person's is `attestation`. */
  readonly origin?: Origin;
  /** Whether a person determines the objective from it. A tool never does. */
  readonly determines: boolean;
};

One record of evidence.

Imported by 9 tests of the run (9 passed, 0 failed): the library's results

Objectivetype
type Objective = { readonly id: string; readonly requirement: string; readonly statement: string };

An objective of a framework, as the assessment reads it: its identifier, its requirement and what it asks.

Imported by 9 tests of the run (9 passed, 0 failed): the library's results

STANDINGSconstno test imports it
const STANDINGS: readonly ["met", "not-met", "not-applicable", "supported", "stale", "no-evidence"]

How one objective stands.

Standingtypeno test imports it
type Standing = (typeof STANDINGS)[number];

A standing.

ROLLUPSconstno test imports it
const ROLLUPS: readonly ["met", "not-met", "not-applicable", "partial", "no-evidence"]

How a requirement stands from its objectives.

Rolluptypeno test imports it
type Rollup = (typeof ROLLUPS)[number];

A roll-up.

Titles, headings, exports, tables, columns and requirements. Esc closes.