Skip to content

[codex] Reflow policy and report schema docs#44

Merged
stacknil merged 1 commit into
mainfrom
codex/reflow-policy-report-schema-docs
May 9, 2026
Merged

[codex] Reflow policy and report schema docs#44
stacknil merged 1 commit into
mainfrom
codex/reflow-policy-report-schema-docs

Conversation

@stacknil
Copy link
Copy Markdown
Owner

@stacknil stacknil commented May 9, 2026

Brief Design Summary

This PR hard-reflows the policy and JSON report schema documentation so the Markdown source is readable in raw views and future diffs.

It preserves the v0.8 policy explainability semantics from the previous PR: policy finding explanation fields remain documented as local policy-decision metadata, not dependency safety verdicts, CVE results, or proof that a package is safe or unsafe.

No runtime behavior, CLI flags, JSON schema, Markdown/SARIF output behavior, workflows, package metadata, release tags, or publishing status changed.

Files Changed

  • tools/sbom-diff-and-risk/docs/report-schema.md
  • tools/sbom-diff-and-risk/docs/policy-schema.md

Validation

  • git diff --check passed.
  • Broad Unicode Cf/Cc scan found no non-tab/newline control or format characters.
  • Confirmed both touched docs have zero source lines over 120 characters.
  • Confirmed package version remains 0.7.0.
  • Confirmed no workflow files changed.

Out of Scope

  • No runtime behavior changes
  • No CLI behavior changes
  • No JSON schema changes
  • No workflow changes
  • No package version bump
  • No tag or GitHub Release
  • No PyPI/TestPyPI publishing
  • No production PyPI workflow

@stacknil stacknil merged commit 9d3920a into main May 9, 2026
5 checks passed
@stacknil stacknil deleted the codex/reflow-policy-report-schema-docs branch May 9, 2026 05:01
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant