`pqkeep list`: authenticated archive listing without extraction

Open
  • Is something wrong?
#117 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
12/100
Issue type
Feature
Clarity
Mostly clear
Activity status
Active
Tech stack
rust
Domain
cli, security

Research direction

The payload names no source files, tests or entry points. Start by confirming the status of the prerequisite issues #116 and #86, then read the linked V-1 plan if one exists. Newcomers should not implement anything yet: the issue requires an approved plan and threat model first. Done means that plan is documented and approved, and any later pqkeep list implementation is opt-in and tested for both success and tampering cases.

Written by the indexing model from the issue text.

Description

area:cli priority:P2 type:feature

Ziel

Nach Entschlüsselung in begrenztem Streaming-Parser nur Dateinamen, Größen und Pfade listen; keine Klartextdateien schreiben, keine Symlinks/aktive Inhalte, vollständige Tag-Prüfung vor VERIFIZIERT.

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

V-1; #86 Check-Funktion wiederverwenden; Sandbox testen.

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: Sichere Dateivorschau (V-2/3).

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.