osqar 0.9.0

Open Safety Qualification Architecture - A Sphinx-Needs boilerplate for safety-related systems.

OSQAr — Open Safety Qualification Architecture

Auditable evidence shipments with traceability. Write requirements, architecture, and verification plans in reStructuredText. Link them with sphinx-needs. Package into integrity-protected shipments. Integrate across teams.

pipx install osqar
osqar new --language c --name hello_safety && cd hello_safety
osqar build-docs && osqar open-docs

Who this is for

Role	Does
Supplier	Produce auditable evidence shipments (docs + code + tests + checksums)
Integrator	Verify, intake, and archive received shipments; enforce dependency closure
Internal team	Standardize evidence packaging across subprojects and CI

Quick links

• 📖 Docs: bitvortex.github.io/OSQAr — full framework documentation
• 📦 Examples: bitvortex.github.io/OSQAr/examples — C, C++, Rust, Python reference projects
• 🔬 Full demo: OSQAr‑cJSON — ISO 26262 SEooC qualification attempt targeting ASIL D (88% coverage, 162 tests)
• 📥 Downloads: GitHub Releases — pre-built framework bundles and example workspaces

Features

Documentation & traceability

• Structured requirements, architecture, verification plans via sphinx-needs + reStructuredText
• PlantUML architecture diagrams embedded in docs
• Machine-readable needs.json exports with full traceability graph
• CSV and Excel (--format xlsx) traceability matrix exports for auditor review
• Change impact analysis (osqar impact) from any seed requirement
• Versioned requirement baselines with snapshot/list/diff (osqar baseline)
• Requirement ID prefix overrides (--req-prefix, --arch-prefix, etc.)

Scaffolding & skills

• Language templates for C, C++, Rust, Python (osqar new --language)
• ASIL‑D C template (osqar new --language c --template asil-d_c) with pre‑populated ISO 26262‑6 software safety requirements, architecture, verification, and lifecycle needs
• Agent‑ready content‑authoring skills (ISO 26262‑6, ISO 21434, ISO 21448, vehicle programs, compliance documentation) — see skills/ and the Agent Skills usage guide
• GSN safety case generation (osqar gsn generate) with PlantUML and gsn2x backends

Shipment & integrity

• One-shot shipment preparation (osqar shipment prepare --archive)
• SHA256SUMS manifest generation and verification
• GPG detached signature support (osqar sign create / osqar sign verify)
• Incremental mode — only rebuild changed stages
• Project metadata declaration with OSQAr-qualified dependency pins

Verification & CI

• Traceability rule enforcement (REQ→ARCH, ARCH→REQ, REQ→TEST)
• Code trace scanning with enforcement (osqar code-trace)
• Configurable verification activities (sanitizers, static analysis, fuzzing)
• Auto-generated gap documentation from osqar_project.json
• PlantUML-free build mode (OSQAR_NO_DIAGRAMS=1) for offline/CI
• Scaffold projects with osqar new --no-diagrams to permanently disable diagrams

Multi-project & organization

• Workspace orchestration: list, report, verify, intake, combine
• Cross-project traceability via namespace-prefixed workspace combine
• Dependency closure enforcement across received shipments
• Lifecycle management and collaboration workflows for multi-user teams
• Reproducible native builds (C/C++/Rust, optional Bazel integration)
• Extensible via project/workspace JSON config + command hooks

Getting started as a developer

git clone https://github.com/BitVortex/OSQAr.git
cd OSQAr
poetry install
osqar build-docs && osqar open-docs

For the full contributor setup (editable install, evidence tools, CI), see the framework docs.