Crafter.Review/interfaces/Crafter.Review-Core.cppm
Jorijn van der Graaf f2b25db50d
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>
2026-10-31 05:51:37 +01:00

43 lines
2.1 KiB
C++

// SPDX-License-Identifier: AGPL-3.0-only
// SPDX-FileCopyrightText: Copyright (C) 2026 Catcrafts®
export module Crafter.Review:Core;
import std;
export namespace Crafter::Review {
// The release this binary was built from, as project.cpp stamped it:
// CRAFTER_REVIEW_VERSION, else `git describe`, else 0.0.0-dev.
std::string_view Version();
// Bumped only when clean results stored under the earlier number must not
// be reused: a text change a lens reads that changes what a clean pass
// proves. It is one of the inputs of every reuse key, so a bump retires
// every stored result at once. A change that leaves what a lens reads the
// same — a layout change, a reworded log line — does not bump it.
constexpr std::int32_t PromptVersion = 1;
// `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();
}