Add ontology decision import preview

[SoundBlaster]

Summary

• What changed?
• Link related issue/task (if any):

Adds SG-RFC-0115, a read-only ontology_decision_import_preview artifact that joins the ontology review dashboard with Ontology owner decisions before any future import workflow.

Motivation

• Why is this change needed?
• What problem, gap, or user need does it address?

After the dashboard and owner-decision report slices, SpecGraph needs a deterministic preview that shows whether accepted/rejected Ontology decisions are blocked, ready for operator review, rejected, clarification-needed, or unmatched without applying those decisions.

Goals

• What should this PR achieve?
• What is intentionally out of scope?

Add the preview contract, builder, validator, docs, registry trace, and tests. Out of scope: applying owner decisions, importing into SpecGraph, closing semantic gates, writing Ontology packages or lockfiles, mutating canonical specs, or adding SpecSpace mutation UI.

Changes

• Adds ontology_decision_import_preview_contract to the semantic control policy and wires the preview into tools/ontology_imports.py.
• Adds SG-RFC-0115 proposal/source docs, operator docs, runtime/promotion registry entries, and focused tests for preview shape, custom output layout, generated artifact smoke, and authority rejection.

Validation

• Tests added/updated for changed behavior
• Local checks passed

Commands run:

/opt/homebrew/bin/python3.10 -m ruff format tools/ontology_imports.py tests/test_ontology_import_policy.py
/opt/homebrew/bin/python3.10 -m json.tool tools/ontology_semantic_control_policy.json >/dev/null
/opt/homebrew/bin/python3.10 -m json.tool tools/proposal_runtime_registry.json >/dev/null
/opt/homebrew/bin/python3.10 -m json.tool tools/proposal_promotion_registry.json >/dev/null
make ontology-imports PYTHON=/opt/homebrew/bin/python3.10
/opt/homebrew/bin/python3.10 -m pytest -q tests/test_ontology_import_policy.py
make proposal-tracking-gate PYTHON=/opt/homebrew/bin/python3.10
make docc-sync PYTHON=/opt/homebrew/bin/python3.10
/opt/homebrew/bin/python3.10 -m ruff check tools/ontology_imports.py tests/test_ontology_import_policy.py
make test PYTHON=/opt/homebrew/bin/python3.10

Results:

• tests/test_ontology_import_policy.py: 73 passed
• proposal-tracking-gate: passed, 115 tracked, 0 blockers
• docc-sync: passed
• ruff check: passed
• make test: 1201 passed

Risks / Notes

• Backward compatibility impact: additive read-only artifact only.
• Migration/config changes required: none.
• Known limitations: does not apply owner decisions or import them into SpecGraph; next gap is build_specspace_owner_decision_review_surface.

Checklist

• PR title clearly describes the change
• Scope is focused and minimal
• Documentation updated (or N/A)
• No secrets or sensitive data added

[Copilot]

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 9573ea4ab0

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".