LOCALHOST1978/Modules/SSK_IntegrationTests/ARCHITECTURE.md

SSK_IntegrationTests Architecture

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:

• 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

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

+-------------------------------------------------------------------+
|                        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