feat(core): the data home, the lens texts, and --version naming both

process/ holds the procedure, the five lens texts, the templates and the
skill under process/skill/prepush/. A lens text's sha256 is part of every
reuse key and the texts are part of every prompt, so they carry no SPDX
header; --version prints the charter hashes: 1728bd4c, 148d5c4c,
c7ffef44 and 2b9a5f83 for the four charters.

Home() finds them: CRAFTER_REVIEW_HOME, natively only (a host setting
must not swap the Flatpak's texts for a checkout's), then
<exe>/../share/crafter-review, then the checkout the binary was built in.
Main() hands `__supervise` to the supervisor before anything else, then
decides the sandbox once.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
Jorijn van der Graaf 2026-10-31 05:51:37 +01:00
commit f2b25db50d
Signed by: jorijnvdgraaf
GPG key ID: 2937E59CDCC1BCFB
12 changed files with 1372 additions and 4 deletions

View file

@ -19,4 +19,25 @@ export namespace Crafter::Review {
// `crafter-review <version> (prompt v<n>)`: the dump's `driver` field,
// the first log line of a run and `--version`.
std::string DriverLine();
// Where the lens texts, the procedure and the templates are: the
// directory that holds process/. In this order:
// - CRAFTER_REVIEW_HOME, natively only: a host setting must not swap the
// Flatpak's lens texts for a checkout's, which would change every reuse
// key without a word;
// - <exe>/../share/crafter-review, which in the Flatpak is
// /app/share/crafter-review;
// - the checkout the binary was built in, when it runs from
// <checkout>/bin/crafter.review-exe-*/.
// Throws std::runtime_error when none of them holds process/lenses.
const std::filesystem::path& Home();
// For tests, which run from neither place.
void SetHome(std::filesystem::path home);
// Home()/process/lenses.
std::filesystem::path LensDir();
// The sha256 of each lens file — the text read with universal newlines,
// as UTF-8 — keyed by file name. Every charter's is part of its lens's
// reuse keys, so --version and the run log print them: a stale home shows
// up there before it shows up as nothing being reused.
std::vector<std::pair<std::string, std::string>> CharterHashes();
}