AirGap Transfer
Development documentation — may change at any time
AirGap Transfer

Dashboard

  • Project Health
    • Specification Coverage
      • Requirements Without Use Case Coverage
      • Tests Without Requirement Links
      • v1.0 Requirements Without Test Coverage
  • Implementation Status
    • Implementation Coverage
    • Requirements Without Implementation
  • Test Status
    • Tests Requiring Attention
    • Test Execution Results
    • All Test Cases
    • v1.0 Test Cases
    • v1.1 Test Cases
    • v1.2 Test Cases
  • Coverage Gaps
    • Functional Requirements Without Tests
    • Non-Functional Requirements Without Tests
    • Requirements Without Implementation Mapping

Specification

  • Overview
    • Features
    • How It Works
    • Quick Start
      • Prerequisites
      • Installation
      • First Transfer
    • Usage
      • Pack Operation
      • Unpack Operation
      • List Operation
    • Building
    • Air-Gapped Deployment
    • Use Cases
    • Privacy
    • Why AirGap Transfer?
    • Platform Support
    • Documentation
      • Start Here
      • Technical Documentation
      • Project Planning
  • Use Cases
    • Use Case Analysis
      • Purpose
      • User Personas
        • IT Administrator
        • Data Scientist / Researcher
        • Security Operations Staff
        • Field Technician
      • Workflow Use Cases
        • Large File Transfer
        • Large Directory Transfer
        • Multiple USB Workflow
        • SBOM Transfer (v1.1)
      • Diagnostic & Operational Use Cases
        • Verify Transfer Integrity
      • Error Recovery & Safety Use Cases
        • Recover from Transfer Failure
        • Protect Against Data Loss
      • Common Requirements Across All Use Cases
      • Integration with AirGap Deploy
      • Out of Scope
      • Success Metrics
    • Use Case: Large File Transfer
      • Scenario
      • Prerequisites
      • Workflow Steps
        • Phase 1: Pack on Source Machine
        • Phase 2: Physical Transfer
        • Phase 3: Unpack on Destination Machine
      • Acceptance Criteria
      • Error Scenarios
      • Linked Requirements
      • Traceability
      • Tests
        • Integration Tests
        • Unit Tests of Linked Requirements
    • Use Case: Large Directory Transfer
      • Scenario
      • Prerequisites
      • Workflow Steps
        • Phase 1: Pack on Source Machine
        • Phase 2: Physical Transfer
        • Phase 3: Unpack on Destination Machine
      • Acceptance Criteria
      • Optimization Notes
      • Error Scenarios
      • Linked Requirements
      • Traceability
      • Tests
        • Integration Tests
        • Unit Tests of Linked Requirements
    • Use Case: Multi-USB Dataset Transfer
      • Scenario
      • Prerequisites
      • Workflow Steps
        • Phase 1: Pack with Multiple USB Swaps
        • Phase 2: Physical Transfer
        • Phase 3: Unpack on Destination
      • Acceptance Criteria
      • Edge Cases
      • User Experience Notes
      • Linked Requirements
      • Traceability
      • Tests
        • Integration Tests
        • Unit Tests of Linked Requirements
    • Use Case: Verify Transfer Integrity
      • Scenario
      • Prerequisites
      • Workflow Steps
        • Step 1: Inspect Chunk Inventory
        • Step 2: Verify Checksums
        • Step 3: Diagnose Issues
        • Step 4: Proceed with Unpack
      • Acceptance Criteria
      • Error Scenarios
      • Related Documents
      • Linked Requirements
      • Traceability
      • Tests
        • Integration Tests
        • Unit Tests of Linked Requirements
    • Use Case: Recover from Transfer Failure
      • Scenario
      • Prerequisites
      • Workflow Steps
        • Scenario A: Pack Interrupted by Insufficient Space
        • Scenario B: Unpack Interrupted by Power Loss
        • Scenario C: Missing Chunks During Unpack
      • Acceptance Criteria
      • Error Scenarios
      • Related Documents
      • Linked Requirements
      • Traceability
      • Tests
        • Integration Tests
        • Unit Tests of Linked Requirements
    • Use Case: Protect Against Data Loss
      • Scenario
      • Prerequisites
      • Workflow Steps
        • Scenario A: Overwrite Protection
        • Scenario B: Pack to Occupied Destination
        • Scenario C: Safe USB Ejection
      • Acceptance Criteria
      • Error Scenarios
      • Related Documents
      • Linked Requirements
      • Traceability
      • Tests
        • Integration Tests
        • Unit Tests of Linked Requirements
  • Requirements
    • Introduction
      • Purpose
      • Scope
      • Definitions
    • Overall Description
      • Product Perspective
      • Constraints
      • Assumptions and Dependencies
    • Functional Requirements
      • Pack Operation
      • Unpack Operation
      • List Operation
      • Integrity Verification
      • Cryptographic Agility
      • State Management
      • Command Interface
      • Error Handling
      • Safety Features
      • Deployment
    • Non-Functional Requirements
      • Performance
      • Reliability
      • Usability
      • Maintainability
      • Portability
      • Scalability
      • Security & Privacy
      • Deployment
    • Appendix: Design Conventions
  • Design
    • Introduction
    • Architecture Overview
      • System Context
      • Design Rationale
    • File Structure
    • Data Design
      • State Persistence
    • Component Design
      • CLI Parser (main.rs)
      • Chunker (chunker.rs)
      • Verifier (verifier.rs)
      • Manifest (manifest.rs)
      • USB Handler (usb.rs)
    • Interaction Flows
      • Pack Operation
      • Unpack Operation
    • Dependencies
    • Security & Privacy
      • v1.2 Encryption Design (Planned)
    • Deployment
      • Air-Gap Support
      • Platform Packages
    • Platform Considerations
      • USB Detection
      • Filesystem Sync
  • Tests
    • Introduction
    • Test Cases by Category
      • Pack Operation Tests
      • Unpack Operation Tests
      • List Operation Tests
      • Integrity Tests
      • Cryptographic Agility Tests
      • State Management Tests
      • Command Interface Tests
      • Error Handling Tests
      • Safety Tests
      • Deployment Tests
      • Non-Functional Tests

Planning

  • Project Roadmap
    • v1.0.0 Release
    • Current Status
    • MVP Scope
    • Implementation Phases
      • Phase 1: Core Infrastructure
      • Phase 2: Pack Operation
      • Phase 3: Integrity & Cryptographic Agility
      • Phase 4: State Management & Resume
      • Phase 5: Unpack & List
      • Phase 6: Safety & Validation
      • Phase 7: CLI Polish
      • Phase 8: Testing & Documentation
    • Definition of Done
    • What’s NOT in MVP
    • After MVP
    • Progress Log
  • Future Release Summary
  • Future Use Cases
  • Use Case: Transfer Deployment Package with SBOM
    • Scenario
    • Prerequisites
    • Workflow Steps
      • Pack with SBOM
      • Transfer
      • Unpack with Audit Trail
    • Acceptance Criteria
    • Related Documents
    • Linked Requirements
    • Traceability
    • Future Use Case Overview
  • Future Requirements
    • v1.1 — SBOM-Aware Transfer Manifests
    • v1.2 — Authenticated Encryption (AEAD) for Chunks at Rest
      • Future Release Overview
  • Future Test Plan
    • Future Test Overview
  • Verification Planning
    • Test Strategy
      • Test Levels
      • Features Not Tested
      • Test Automation Approach
    • Test Procedures
      • Offline Operation Test (TC-TRANSFER-NFR-003)
      • Checksum Verification Test (TC-INT-003)
    • Pass/Fail Criteria

Implementation

  • Implementation Mapping
    • Module Overview
      • Chunker Module
      • Verifier Module
      • Manifest Module
      • USB Module
      • Command Modules
        • Pack Command
        • Unpack Command
        • List Command
      • CLI Infrastructure
        • CLI Flags
        • Error Handling
        • Safety
        • Build
        • Resume
  • API Reference
    • Generating API Docs
AirGap Transfer
  • Search

© Copyright 2026, Cleanroom Labs.