Buckets:
| # SSK_IntegrationTests Architecture | |
| > [!IMPORTANT] | |
| > **Version Control and State Tracking Rule**: | |
| > This repository exclusively uses **`lore`** for version control, state management, and documentation tracking. **Do NOT use `git`**. | |
| --- | |
| ## 1. Overview and Purpose | |
| `SSK_IntegrationTests` is the central test harness and integration verification module of the **SovereignSurvivalKit** architecture. It links all 8 core framework modules to perform end-to-end integration testing, hardware simulation, PRD compliance testing, evaluation dataset scoring, and snippet rendering UI tests. | |
| --- | |
| ## 2. Package Specifications and Dependencies | |
| Defined in [`Package.swift`](file:///Users/voxels/SovereignSurvivalKit/src/SovereignSurvivalKit/Modules/SSK_IntegrationTests/Package.swift): | |
| - **Target Name**: `SSK_IntegrationTests` | |
| - **Swift Tools Version**: `6.4` | |
| - **Supported Platforms**: macOS 27.0+, iOS 27.0+ | |
| - **Internal Package Dependencies**: | |
| - `SSK_Physics` | |
| - `SSK_Abstractions` | |
| - `SSK_Foundation` | |
| - `SSK_Hardware` | |
| - `SSK_Providers` | |
| - `SSK_Orchestrator` | |
| - `SSK_Intents` | |
| - `SSK_UI` | |
| --- | |
| ## 3. Directory Layout and Components | |
| ```text | |
| SSK_IntegrationTests/ | |
| ├── Package.swift | |
| ├── ARCHITECTURE.md | |
| ├── Sources/ | |
| └── SSK_IntegrationTests/ | |
| └── Mocks/ | |
| ├── MockAudioTap.swift # Hardware mock tap providing deterministic PCM frames | |
| └── MockSecureEnclave.swift # Software mock for Apple Secure Enclave operations | |
| └── Tests/ | |
| ├── SSK_IntegrationTests/ | |
| │ ├── IntegrationTestBase.swift # Base test class with async setup and teardown | |
| │ ├── Domain1_HeadlessHostTests.swift # Headless daemon lifecycle and signal trapping | |
| │ ├── Domain2_PhysicsTelemetryTests.swift # Real-time tau-dynamics and carrier clock | |
| │ ├── Domain3_SubtractiveInversionTests.swift # Stem separation and phase cancellation | |
| │ ├── Domain4_EncodingProtocolTests.swift # ACP/UCP serialization and SSKURI resolution | |
| │ ├── Domain5_SovereignVaultTests.swift # Encrypted vault mounting, migrations and ACLs | |
| │ ├── PRD3_PredictorCorrectorTests.swift # PRD-3 trajectory estimation test suite | |
| │ ├── PRD7_IdentitySettlementTests.swift # PRD-7 Zero-Knowledge settlement flows | |
| │ ├── PRD8_MeshWebRTCTests.swift # PRD-8 P2P mesh and WebRTC transport tests | |
| │ ├── PRD9_MandatoryValidationTests.swift # PRD-9 mandatory regulatory and safety checks | |
| │ ├── SSKURITests.swift # Canonical SSKURI parser validation | |
| │ ├── AudioFixtures/ # Deterministic .wav audio fixture files | |
| │ └── Evaluations/ # Evaluation datasets and ground-truth metrics | |
| │ | |
| └── SSK_UITests/ | |
| ├── UITestBase.swift # Base class for UI rendering and view inspection | |
| └── SnippetRenderingUITests.swift # Tests rendering of Siri/Shortcuts snippet views | |
| ``` | |
| --- | |
| ## 4. Test Domains and Responsibilities | |
| ### 1. Mock Hardware Harnesses | |
| - **`MockAudioTap.swift`**: Generates synthetic float32 mono PCM carrier waves (96 kHz) and test audio pulses without requiring physical microphone access. | |
| - **`MockSecureEnclave.swift`**: Simulates key generation, signing, and attestation for automated continuous integration environments. | |
| ### 2. Five Core Architecture Domains | |
| - **Domain 1 (Headless Host)**: Validates headless lifecycle execution (`LSUIElement`), XPC command routers, and signal trapping. | |
| - **Domain 2 (Physics Telemetry)**: Verifies polynomial smoothing, $\tau$-dynamics calculations, and phase-locked clock synchronization. | |
| - **Domain 3 (Subtractive Inversion)**: Tests MLX HTDemucs audio stem separation accuracy and phase-cancellation residual thresholds. | |
| - **Domain 4 (Encoding Protocols)**: Tests serialization, schema migration, and canonical `ssk://` URI parsing. | |
| - **Domain 5 (Sovereign Vault)**: Verifies AES-GCM vault encryption, `.sparsebundle` volume mounting, and CRDT conflict resolution. | |
| ### 3. UI Snippet Verification | |
| - **`SnippetRenderingUITests.swift`**: Verifies dynamic SwiftUI snippet rendering (`AudioIngestionSnippetView`, `FinderSnippetView`) under various simulated viewport dimensions and system color schemes. | |
| --- | |
| ## 5. Architectural Position | |
| ```text | |
| +-------------------------------------------------------------------+ | |
| | SSK_IntegrationTests | | |
| | - Domain Tests 1-5 - PRD Compliance Suites | | |
| | - MockAudioTap & MockEnclave - SnippetRenderingUITests | | |
| +---------------------------------+---------------------------------+ | |
| │ | |
| ┌──────────────┬─────────┴───────┬──────────────┐ | |
| ▼ ▼ ▼ ▼ | |
| SSK_Physics SSK_Abstractions SSK_Foundation SSK_Hardware | |
| ▼ ▼ ▼ ▼ | |
| SSK_Providers SSK_Orchestrator SSK_Intents SSK_UI | |
| ``` | |
Xet Storage Details
- Size:
- 5.24 kB
- Xet hash:
- 1ecf0083cf8437af45af226acd742bc8125bb89461c8a4d590cc300f6480aea0
·
Xet efficiently stores files, intelligently splitting them into unique chunks and accelerating uploads and downloads. More info.