OSCAL 1.2.2 integration | AgentDirective documentation

Three projections, one canonical source

catalogControl Pack library

Pack objectives, questions, requirements, and explicitly partial external mappings.

profileOne compiled directive

Selected safeguards and only the parameter values the user actually confirmed.

assessment-resultsStatus observations

Agent-reported status and optional bounded metadata-review outcomes, with no control findings.

Minimal integration path

Fetch
Fetch the catalog
Read GET https://agentdirective.org/api/oscal/catalog and cache it by metadata.version and metadata.oscal-version.
Compile
Compile a directive
Use the browser, API, CLI, or MCP workflow. A downloaded bundle contains .agentdirective/oscal-profile.json.
Resolve
Resolve the import
The profile imports the public catalog and includes the selected pack and requirement identifiers.
Preserve
Preserve open decisions
Only confirmed values appear under modify.set-parameters. Never default a parameter that the profile leaves unset.
Interpret
Display status honestly
Treat assessment-results entries as observations. Do not convert metadata-review vocabulary into compliant/non-compliant status.

Public OSCAL cataloghttps://agentdirective.org/api/oscal/catalog

Compatibility and migration

ConsumerSupportAction

OSCAL 1.2.2 catalog/profileNativeValidate directly

OSCAL 1.2.2 assessment resultsObservation-onlyPreserve no-finding boundary

OSCAL 1.1.x onlyNot declared compatibleConvert explicitly and revalidate

AgentDirective nativeCanonicalPrefer agent-directive.json

No stored AgentDirective artifact needs an in-place migration. Regenerate the OSCAL projection from the canonical directive or status document so the declared version and schema-validated structure move together.

Repository-local export

CLI

agentdirective oscal .agentdirective
agentdirective oscal .agentdirective --model catalog
agentdirective oscal .agentdirective --model assessment-results \
  --review-report review-report.json

The public catalog and every generated projection declare OSCAL 1.2.2 and are validated against NIST's published JSON schemas during the release gate.