Jonathan D.A. Jewell <jonathan.jewell@gmail.com> :toc: macro :icons: font :source-highlighter: rouge :experimental: :url-github: https://github.com/hyperpolymath/januskey :url-gitlab: https://gitlab.com/hyperpolymath/januskey :url-bitbucket: https://bitbucket.org/hyperpolymath/januskey :url-codeberg: https://codeberg.org/hyperpolymath/januskey
Provably Reversible File Operations Through Maximal Principle Reduction
JanusKey is a file operation utility suite that achieves complete reversibility through architectural design rather than logging or backups. Unlike traditional backup systems that restore from external state, JanusKey operations carry sufficient information for perfect inversion—making data loss architecturally impossible.
-
100% Reversible - Every operation can be undone, always
-
Instant Rollback - Undo changes in milliseconds
-
Data Loss Impossible - Not "unlikely"—architecturally impossible
-
Complete Audit Trail - Every change tracked automatically
-
Transaction Support - Group operations, commit/rollback together
-
Content-Addressed Storage - SHA256 hashing with deduplication
# Build from source (requires Rust) cd src/januskey cargo build --release # Initialize JanusKey in your project jk init # Delete files (reversible) jk delete *.log # Undo the delete jk undo # Transactions for batch operations jk begin jk delete temp*.txt jk modify "s/DEBUG/INFO/g" config.yaml jk preview # Review changes jk commit # Or: jk rollback
| Command | Description |
|---|---|
|
Initialize JanusKey in current directory |
|
Delete files (reversible) |
|
Modify files with sed-like syntax |
|
Move/rename files |
|
Copy files |
|
Undo last operation(s) |
|
Start a transaction |
|
Commit current transaction |
|
Rollback current transaction |
|
Preview pending changes |
|
Show operation history |
|
Show current status |
JanusKey implements Maximal Principle Reduction (MPR), a security methodology where vulnerability elimination occurs by construction rather than verification.
+----------------------------+ | JanusKey CLI | <-- jk delete, jk modify, jk move +----------------------------+ | Operation Layer | <-- Generates inverse metadata +----------------------------+ | Transaction Manager | <-- Groups ops, commit/rollback +----------------------------+ | Metadata Store | <-- Append-only operation log +----------------------------+ | Content-Addressed Storage | <-- SHA256, deduplication +----------------------------+
| Platform | URL |
|---|---|
GitHub (primary) |
{url-github} |
GitLab |
{url-gitlab} |
Bitbucket |
{url-bitbucket} |
Codeberg |
{url-codeberg} |
Licensed under MIT OR PMPL-1.0-or-later.
See LICENSE.txt for details.
See CONTRIBUTING.adoc.
JanusKey is based on research into provably reversible computing and Maximal Principle Reduction. See the white paper in docs/ for formal proofs and theoretical foundations.
-
Domain: software-development
-
Framework: RSR (Rhodium Standard Repository)
-
Language: Rust
-
Dublin Core: .well-known/dc.xml