_text/ is derived from the PNG tEXt chunks and settings.json, and derived data
regenerated by hand goes stale silently -- which is worse than absent, because a
stale card reads as current. A pre-commit hook now regenerates and stages it.
Blocking, unlike the halogen repo's advisory doc-check: that one reports a
judgement call, this one rebuilds a file. Install with
`./st-export.py --install-hook`, since hooks are not versioned.
Verified by renaming a persona in the untracked settings.json and committing
WITHOUT running the export -- _text/personas.json updated itself and was
included. Test edit reverted.
Tracked inside SillyTavern's live data directory rather than symlinked out of
it. data/ is a bind mount into the container, so a symlink to a host path
outside that mount resolves inside the container where the target does not
exist -- broken to SillyTavern while looking correct on the host.
The .gitignore is an allowlist, denying everything and re-including named paths,
because this is live application data rather than a curated export. secrets.json
is the reason: empty today because API keys go through LiteLLM with a
placeholder, and it arms itself the moment a key is typed into the UI. This repo
is public. A denylist protects only the paths someone remembered.
Two of the four artifact types are not diffable as stored. Character cards are
PNGs with the card JSON in a tEXt chunk, and personas live inside a 48 KB
settings.json that SillyTavern rewrites on any change. st-export.py extracts
both into _text/ so the reviewable artifact is text, one-way on purpose --
re-embedding JSON into a PNG is where a mistake corrupts authored content.
Stock content is excluded: Seraphina's expression pack is 3.6 MiB of PNG the app
regenerates on startup. The stock lorebook Eldoria.json stays -- 8 KB of
readable JSON is a useful worked example of the format.
mikkeli
Mikkeli