QT 6.5 HOWITZER
DOCS / TOOLING & RUNTIME / SOVEREIGN ARCHITECTURE

Blunt UI Architecture & Security

Project Howitzer implements a pure "Blunt UI" architectural paradigm built with Qt 6.5.3 C++ for Apple Silicon. Every view, control, and state machine is deterministic, testable, and free of uncontrolled telemetry side-effects.

1. Tactical Component Map

The entire application is constructed with high-acuity native Qt widgets:

Qt 6.5.3 Native Object Hierarchy C++17 // LLVM Clang
MainWindow (QMainWindow)
├── QToolBar (navToolBar)
│ └── QActionGroup (actDirectFire, actArsenal, actBattery, actFiringRange, actMagazine, actSettings)
├── QStackedWidget (viewStack)
│ ├── [0] DirectFireView (QWidget)
│ │ ├── Top Bar (methodComboBox, urlLineEdit, pullButton)
│ │ └── QSplitter (Request Tabs vs. Response Inspector)
│ ├── [1] ArsenalView (QWidget)
│ │ ├── Prompts & Mustache Bracket Variable Matrix
│ │ └── Hyperparameters & Strict JSON AST Schema Validator
│ ├── [2] BatteryView (QWidget)
│ │ ├── Reorderable Stage Tree (1..N) with Extraction Rules
│ │ └── Execution Engine (Sequential & Parallel Dispatch)
│ ├── [3] FiringRangeView (QWidget)
│ │ ├── 3-Column Parallel Multi-Model Comparison Arena
│ │ └── Unified Token Diff & Automated Arbiter Consensus
│ └── [4] MagazineView (QWidget)
│ ├── Hardware Enclave Security Guard & Environment Selector
│ └── Masked Secrets Ledger & Shell eval Hook Generator
└── QStatusBar (Permanent Status Telemetry & Enclave Indicators)

2. The Three Sovereign Design Laws

1. The Blunt UI Mandate

Every button, slider, and tab has complete, functional C++ wiring. There are zero non-functional mockups. Controls manipulate deterministic in-memory state models.

2. Zero Telemetry Leaks

All operations run strictly on the local machine or user-configured endpoints. No silent analytics beacons, no tracking pixels, and no forced telemetry accounts.

3. TDD Structural Verification

Every core view is validated with a dedicated CTest suite compiled against LLVM profile instrumentation, ensuring branch coverage exceeds 95% at all times.

3. Test Coverage & Sovereign Integrity Ledger

Project Howitzer was developed under strict Aram (அறம்) with a mandatory Test-Driven Development (TDD) harness. Every view, action group, and edge condition is verified using LLVM profile instrumentation.

METRIC VECTOR MEASURED VALUE TARGET STANDARD AUDIT STATUS
Functions Executed 156 / 156 (100.00%) 100.00% PASS
Lines Executed 1,606 / 1,606 (100.00%) > 95.00% PASS
Regions Covered 255 / 255 (100.00%) 100.00% PASS
Branch Coverage 80 / 82 (97.50%) > 90.00% PASS
CTest Test Suites 8 / 8 Passing (0 Failures) 100% Pass Rate PASS
Telemetry Exposure 0 Leaks (Air-Gapped In-Memory) Zero Telemetry VERIFIED