AirGap Transfer
dev
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
AirGap Transfer Docs
Edit on GitHub
AirGap Transfer Docs
Dashboard
Project Health
Specification 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
Usage
Building
Air-Gapped Deployment
Use Cases
Privacy
Why AirGap Transfer?
Platform Support
Documentation
Use Cases
Use Case Analysis
Use Case: Large File Transfer
Use Case: Large Directory Transfer
Use Case: Multi-USB Dataset Transfer
Use Case: Verify Transfer Integrity
Use Case: Recover from Transfer Failure
Use Case: Protect Against Data Loss
Requirements
Introduction
Overall Description
Functional Requirements
Non-Functional Requirements
Appendix: Design Conventions
Design
Introduction
Architecture Overview
File Structure
Data Design
Component Design
Interaction Flows
Dependencies
Security & Privacy
Deployment
Platform Considerations
Tests
Introduction
Test Cases by Category
Planning
Project Roadmap
v1.0.0 Release
Current Status
MVP Scope
Implementation Phases
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
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 Test Plan
Future Test Overview
Verification Planning
Test Strategy
Test Procedures
Pass/Fail Criteria
Implementation
Implementation Mapping
Module Overview
API Reference
Generating API Docs