Transparency
Full visibility into decision logic, data model, and quality controls.
Decision policy
- No ranking, no recommendation engine, and no hidden scoring.
- No weights or heuristics. Matching is pass/fail plus explicit reasons.
- Same answers produce the same result set every time.
- UI renders engine outputs only. Logic lives in data + engine layer.
Logic inventory
Questions
35
Options
114
Hard constraints
8
Soft reasons
15
Active constraint labels available to users: 27
Distro dataset snapshot
Current distro records in the dataset: 44
Release model
- FIXED: 33
- ROLLING: 11
Package manager
- APT: 24
- DNF: 6
- OTHER: 6
- PACMAN: 4
- ZYPPER: 2
- APK: 1
- NIX: 1
Init system
- SYSTEMD: 38
- OTHER: 3
- OPENRC: 2
- RUNIT: 1
Installer and maintenance
- Installer GUI: 38
- Installer MANUAL: 6
- Maintenance LOW_FRICTION: 27
- Maintenance HANDS_ON: 17
Data quality and validation
- TypeScript strict mode
- Zod schema validation for intent, questions, and distro data
- Flow validator for declarative condition and patch correctness
- Question catalog validation
- Distro data validation
- Distro consistency audits
Recommended local checks:
npm run validate:flow, npm run validate:questions, npm run validate:distros, npm run audit:distrosSource documents
docs/ARCHITECTURE.mddocs/DATA_CONTRACT.mddocs/DATA_RULES.mddocs/CONSTRAINT_MAPPING.mddocs/QUESTION_CATALOG.mddocs/DISTRO_COVERAGE_AUDIT.mddocs/TESTING.md