diff options
| author | Gabriel Schneider <[email protected]> | 2026-11-05 15:40:52 -0300 |
|---|---|---|
| committer | Gabriel Schneider <[email protected]> | 2026-11-05 19:16:37 -0300 |
| commit | b48f79a1c19c4c96c30d29d5f8ac5ad19c8e3475 (patch) | |
| tree | 65a7620c2826bb03167c32e1df4681ed5c0b4f55 /src | |
| parent | cd712084c68b9e2bad350066a92a96ce78a9ff35 (diff) | |
| download | pardes-b48f79a1c19c4c96c30d29d5f8ac5ad19c8e3475.tar.gz pardes-b48f79a1c19c4c96c30d29d5f8ac5ad19c8e3475.zip | |
docs: the state file and the dumps as they are now: the reference's Dump and Restore paragraph (a label, `/dumps`, `Dump export <path>` to carry one, Restore of a label or a path, the words for a label the file keeps none of), its DumpDir row (the state file's directory, one that cannot be read kept aside), `/recent` kept in the state file, `/dumps` among the root files, the snapshots and the stats, and the log's `dump` and `restore` records; building.typ's Upgrade (`upgrade-<pid>` in the state file, the build before's `.dump` still read); setup.typ's new list of the files pardes keeps (the startup file and the crash record, the state file, the blob cache, the runtime directory's, and the build before's to delete); next-store.md's decision (everything on disk through xitdb, with the measured costs) over W4's, the closed panes under it and its tests as they are; and the changelog's entry, what a user must know: labels where dump files were, `Dump export`, `.dump` files read for one release, Recent read once from its old file, DumpDir now the state file's directory, the old cache directory no longer read, an unreadable state file kept aside
Co-Authored-By: Claude Opus 5.5 <[email protected]>
Claude-Session: https://claude.ai/code/session_016Y9MNAtZenFv4weoMD3cge
Diffstat (limited to 'src')
| -rw-r--r-- | src/CHANGELOG.md | 28 |
1 files changed, 28 insertions, 0 deletions
diff --git a/src/CHANGELOG.md b/src/CHANGELOG.md index 346b5214..08b86064 100644 --- a/src/CHANGELOG.md +++ b/src/CHANGELOG.md @@ -2,6 +2,34 @@ ## Unreleased +- What pardes keeps on disk is in xitdb databases now (a pinned commit of + github.com/xit-vcs/xitdb, pure Zig). The state file, `pardes.xitdb` in + the DumpDir (`$XDG_DATA_HOME/pardes`, else `~/.local/share/pardes`), + keeps Recent and the dumps, shared by every session of the user; a far + client's blob cache is `cache.xitdb` in `$XDG_CACHE_HOME/pardes` (else + `~/.cache/pardes`). What to know: + - Dump puts the session in the state file under a label, + `pardes-<date>-<time>` (UTC), where it wrote `pardes-<date>-<time>.dump`; + the workspace tag's word is `Restore <label>`. `/dumps` lists them, the + newest first: `<label> <date> <size> <panes>`. The newest 32 are kept, + and a text unchanged since the dump before is kept once. `Dump export + <path>` writes one to a file of its own instead, which `-l <path>` and + `Restore <path>` read: the way to carry a session to another machine. + - Restore takes a label or a path; bare, the last dump this session made, + else the newest. + - An old `.dump` file is still read by `Restore <path>` and `-l <path>`, + for this release only: Restore it and Dump again to keep it. + - Recent moves from `~/.local/state/pardes/recent` into the state file: + the first session reads that file once (else the older `store` beside + it) and leaves it; both can be deleted once a session has run. + - DumpDir is the state file's directory, so Recent follows it too. + - Upgrade commits the session to the state file as `upgrade-<pid>` + before the exec; one from the build before, which writes a `.dump` + file, is read as before. The label stays among the dumps. + - A far client's cache directory, `~/.cache/pardes/blobs`, is no longer + read: delete it. + - A state file pardes cannot read as one is kept aside as + `pardes.xitdb.broken`, and a new one started. - The DOM web shell is gone: `-Dplatform=web` and `-Ddump`, the `web`, `web-harness`, `web-snap`, `web-e2e` and `web-driver-test` steps, and `src/web/`; every build has a host now, so what only a freestanding |
