Feature Matrix & Capabilities
ImportShield delivers an integrated suite of twelve specialized diagnostic, recovery, and protection modules designed to guarantee project stability and eliminate import anxiety.
Complete Feature Matrix
| Module | Core Functionality | Primary Trigger / UI Location | Key Safety Mechanism |
|---|---|---|---|
| Pre-Import Snapshots | Atomic reference graph freeze & incremental indexer | Automatic on package import / Tools ▸ ImportShield | GZip binary snapshots with (path, size, mtime) stat cache |
| Package Preflight | Sandboxed .unitypackage scan with GREEN / AMBER / RED verdict | Tools ▸ ImportShield ▸ Preflight Package... | Evaluates archive tar headers before disk modification |
| Blast Radius & Repair | Vector node visualizer & evidence-ranked repair engine | Changes tab | Multi-strategy confidence scoring (R1–R7) & two-pane line diffs |
| Quarantine & Conflicts | Zero-silent-deletion storage & post-import edit preservation | ProjectDoctorData/Quarantine & Conflicts | Isolates files outside Assets/ with intact GUIDs; protects user work |
| Protection Watchers | Background event listeners & crash recovery monitors | Automatic runtime lifecycle | ImportGuardHooks, CrashRecoveryWatcher, DurableVerificationQueue |
| Safe Cleanup Engine | Reachability analysis, duplicate merger & bloat detection | Cleanup tab | String-literal scanner protects Resources.Load & Addressables |
| Material Doctor | Pink shader healing & URP Lit property translation | Materials tab | Automated property mapping (_MainTex → _BaseMap, etc.) |
| Missing Component Stripper | Dead MonoBehaviour removal without sibling corruption | Stripper tab | Surgical YAML array pruning with pre-strip transaction backups |
| Audit Certificate | Health reporting & SHA-256 digital fingerprinting | Reports tab | Formal cryptographic attestation of project reference integrity |
| Time Machine | Snapshot scrubber & historical graph rewind | History tab | Instant comparison between any two historical project states |
| Command Line Interface (CLI) | Headless batchmode runner for CI/CD gates | Terminal / CI pipeline scripts | Configurable threshold assertions with exit codes 0, 1, 2 |
Operational Architecture: Observation, Diagnosis, Repair
All ImportShield modules operate across three strictly enforced architectural boundaries:
┌─────────────────────────────────────────────────────────────┐
│ 1. OBSERVATION │
│ - Fast YamlLineScanner parses token streams │
│ - Stat-cache eliminates redundant I/O │
│ - In-memory GuidIndex maps GUID/fileID references │
└──────────────────────────────┬──────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────┐
│ 2. DIAGNOSIS │
│ - Strict Provenance Separation (New Breaks vs Pre-existing) │
│ - Cause Attribution taxonomy (C1–C8) │
│ - Evidence scoring & confidence categorization (R1–R7) │
└──────────────────────────────┬──────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────┐
│ 3. REPAIR & VERIFICATION │
│ - Atomic byte backup of targets to ProjectDoctorData/ │
│ - Journal state recorded as 'Prepared' │
│ - Line-level patch applied with preserved line-endings │
│ - Immediate post-patch verification (Fail-Closed on error) │
└─────────────────────────────────────────────────────────────┘
“No tool can truthfully guarantee ‘zero risk’ or ‘zero data loss’; ImportShield fails closed and tells you the truth instead of pretending otherwise.”
Detailed Feature Guides
Dive into the dedicated guides below to master each individual module:
- Pre-Import Snapshots
- Package Preflight
- Blast Radius & Repair
- Quarantine & Conflicts
- Protection Watchers
- Safe Cleanup Engine
- Material Doctor
- Component Stripper
- Audit Certificate
- Time Machine
- Command Line Interface (CLI)