NikitolProject/android-encrypted-archiver
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs(05-01): complete shell decoder plan

Browse Source 
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
NikitolProject
2026-02-25 01:41:57 +03:00
parent 6df2639a45
commit ac169c286c
3 changed files with 122 additions and 18 deletions
Download Patch File Download Diff File Expand all files Collapse all files

30
.planning/STATE.md
View File

@@ -5,22 +5,22 @@
See: .planning/PROJECT.md (updated 2026-02-24)
**Core value:** Archive impossible to unpack without knowing the format -- standard tools (7z, tar, unzip, binwalk) cannot recognize or extract contents
**Current focus:** Phase 4 complete, ready for Phase 5
**Current focus:** Phase 5 in progress (Shell Decoder)
## Current Position
Phase: 4 of 6 (Kotlin Decoder) -- COMPLETE
Plan: 1 of 1 in current phase (all done)
Status: Phase 4 complete, ready for Phase 5
Last activity: 2026-02-25 -- Kotlin archive decoder with full decode pipeline and cross-validation test script
Phase: 5 of 6 (Shell Decoder)
Plan: 1 of 2 in current phase
Status: Plan 1 complete, Plan 2 (cross-validation tests) remaining
Last activity: 2026-02-25 -- Busybox-compatible shell decoder script (shell/decode.sh)
Progress: [██████░░░░] 60%
Progress: [███████░░░] 70%
## Performance Metrics
**Velocity:**
- Total plans completed: 6
- Average duration: 4.5 min
- Total plans completed: 7
- Average duration: 4.1 min
- Total execution time: 0.5 hours
**By Phase:**
@@ -31,9 +31,10 @@ Progress: [██████░░░░] 60%
| 2. Core Archiver | 2/2 | 6 min | 3 min |
| 3. Round-Trip Verification | 2/2 | 8 min | 4 min |
| 4. Kotlin Decoder | 1/1 | 4 min | 4 min |
| 5. Shell Decoder | 1/2 | 3 min | 3 min |
**Recent Trend:**
- Last 5 plans: 4min, 2min, 3min, 5min, 4min
- Last 5 plans: 2min, 3min, 5min, 4min, 3min
- Trend: stable
*Updated after each plan completion*
@@ -66,6 +67,11 @@ Recent decisions affecting current work:
- Phase 4: RandomAccessFile for seeking to data blocks instead of reading entire archive into memory
- Phase 4: HMAC failure skips file, SHA-256 mismatch warns but writes (matching Rust behavior)
- Phase 4: Kotlin signed byte handling with .toByte() for literals > 0x7F, contentEquals() for ByteArray comparison
- Phase 5: POSIX sh (not bash) for maximum busybox compatibility
- Phase 5: xxd/od auto-detection at startup for hex conversion
- Phase 5: Graceful HMAC degradation when openssl lacks -mac support
- Phase 5: Extract ciphertext to temp file before decryption (avoids pipe buffering issues)
- Phase 5: LC_ALL=C for predictable byte handling across locales
### Pending Todos
@@ -73,12 +79,12 @@ None yet.
### Blockers/Concerns
- Open question: Does target busybox have `openssl enc -aes-256-cbc` with `-K`/`-iv` flags? (affects Phase 5)
- Open question: Is `xxd` available in target busybox? Fallback: `od` (affects Phase 5; spec includes od fallback functions)
- RESOLVED: openssl enc with -K/-iv flags implemented in shell decoder; script fails gracefully if openssl missing
- RESOLVED: xxd/od auto-detection implemented in shell decoder (xxd primary, od fallback)
- RESOLVED: HMAC uses same key as AES in v1 (decided in Phase 1 spec, v2 will use HKDF)
## Session Continuity
Last session: 2026-02-25
Stopped at: Completed 04-01-PLAN.md (Kotlin decoder + cross-validation tests; Phase 4 complete)
Stopped at: Completed 05-01-PLAN.md (Shell decoder script; Phase 5 Plan 1 of 2)
Resume file: None