Resume interrupted encryption: design and opt-in implementation

Open
  • Is something wrong?
#121 2 comments 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 1 day

Nobody has claimed this yet.

Assessment

Difficulty
5/5
Estimated time
Over a week
Newbie friendliness
15/100
Issue type
Feature
Clarity
Mostly clear
Activity status
Active
Tech stack
rust
Domain
cryptography, security

Research direction

This is a design task: the deliverable is an ADR and threat model, not code, and the issue says no implementation until the plan is approved. Read the prerequisite issue #120 first and check the existing STREAM format and .pqkf file handling it refers to, so the design keeps them unchanged. Done means the ADR, acceptance cases and risk assessment are documented and approved by a maintainer.

Written by the indexing model from the issue text.

Description

area:core priority:P3 type:research

Ziel

ADR: authentisierte Checkpoints, Nonce-Eindeutigkeit, Dateiquellenänderung, Schlüsselbindung, Angreifer mit Schreibrechten, atomarer Abschluss; noch keine Implementierung.

Scope / Grenzen

  • Genau dieser kleine Schritt, kein Big-Bang-Refactoring.
  • Kein Remote-Zugriff, keine neuen offenen Ports, keine automatische Migration.
  • Vor Implementierung kurzer Plan mit Risiko-/Sicherheitsbewertung und Freigabe.

Abhängigkeiten und Überschneidungen

P-1; bestehendes STREAM-Format darf nicht still verändert werden.

Tests

  • Unit- und Integrationstests für Erfolgs-, Fehler-, Grenzwert- und Manipulationsfälle.
  • Regression: bestehende CLI, API, Schlüsseldateien und .pqkf-Dateien weiterhin lesbar/nutzbar.
  • Windows/Linux prüfen, sofern betroffen; CI fmt, clippy, tests, audit und relevante Fuzz-/Property-Tests.
  • Keine Secrets in Logs, Fehlermeldungen, Prozessargumenten oder Testfixtures.

Definition of Done

  • Plan, Threat Model/ADR und konkrete Akzeptanzfälle dokumentiert und freigegeben.
  • Funktion isoliert umgesetzt; standardmäßig aus, sofern neue risikobehaftete Funktion.
  • Positiv-/Negativtests und Rückwärtskompatibilität nachgewiesen; CI grün.
  • DE/EN Dokumentation und Einschränkungen aktualisiert.
  • Review und eigenständiger PR, ohne vorgezogene Folgeschritte.

Rollback

  • Bestehender Betriebsweg bleibt erhalten; Feature-Flag/opt-in für neue Funktionen.
  • Keine automatische Format-/Datenmigration oder destruktive Operation.
  • Rücknahme des PR bzw. Abschalten des Features stellt den bisherigen Betrieb wieder her; Test dafür dokumentieren.

Themenreihe: Fortschritt und Wiederaufnahme (P-3/4).

Dominant language
Rust
Stars
0
Forks
0
Avg merge
1h 22m
Merged PRs (30d)
72

Getting set up

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from SpecterAoD/pqkeep

All issues in SpecterAoD/pqkeep

Similar issues

More Rust issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.