| Version | Supported |
|---|---|
| 0.1.x-alpha | Yes |
handoffstone is pre-release. Security fixes land on main and ship in the
next alpha tag.
The library is local-first and dependency-free. By default it writes JSONL under
~/.handoffstone (override with HANDOFFSTONE_HOME). Do not put secrets, API
keys, tokens, or passwords into records. Prefer recording where a secret lives,
not the secret itself.
- A project
scopeis a single filename component. Empty names,.,.., path separators, and NUL are rejected. - Context store paths that are symlinks are refused.
- New store files are created with mode
0600on POSIX.
Concurrent replacement of a store file and multi-writer transaction safety are
out of scope for the current alpha. Do not point HANDOFFSTONE_HOME at a shared
or untrusted directory.
Please do not open a public issue for security problems.
Report it through private vulnerability reporting. If that form is unavailable, email contact@solveny.co. Include:
- A short description of the issue and impact.
- Steps to reproduce, or a minimal script against the current
main. - Affected version or commit SHA if known.
You should hear back within a few days. After a fix ships, we will credit you in the changelog if you want that.