docs(ai): drop planning vocabulary from the ledger comments

CLAUDE.md forbids planning shorthand in committed artefacts, and this branch
introduced 74 lines of it across source, tests, a schema field and two
migrations. Someone reading the migration SQL in a year has no way to resolve a
wave letter or a round number, and a comment that points at something outside
the repository names no reason at all.

Three passes. A version followed by a parenthetical keeps the version and loses
the parenthetical, because the version says since when something holds. A
sentence that leaned on the vocabulary to carry its meaning is rewritten to
state the reason directly: the arrival reservation now says it was refused over
money the operator never spent, rather than naming the defect a wave existed to
remove. Three test titles carried the marker in the name itself and are renamed
to what they pin.

Comments only. No behaviour, no renames beyond those three titles.
This commit is contained in:
Marc-André Bombeck committed 2026-09-11 12:37:54 +02:00
1 parent c66bcbc295
commit b565edc48d
30 files changed
+86 -84

No files matched your search

@@ -207,7 +207,7 @@ describe("GET /api/admin/provider-health", () => {
});
/**
* v1.38.19 (Wave E) — the two spend figures side by side.
* v1.38.19 — the two spend figures side by side.
*
* The operator reads this card when the chat refuses. Until now it showed
* delivery health only, and the day's token figure was one number that mixed
+1 -1
View File
@@ -111,7 +111,7 @@ export const GET = apiHandler(async () => {
return a.providerType.localeCompare(b.providerType);
});
// v1.38.19 (Wave E) — the day's spend, split by who pays for it.
// v1.38.19 — the day's spend, split by who pays for it.
//
// The operator opens this card when a surface refuses on budget. One mixed
// number could not answer the question it raised: a day at 1.24 M tokens is
+2 -2
View File
@@ -609,7 +609,7 @@ async function handleChatRequest(request: NextRequest): Promise<Response> {
"coach",
);
if (!reservation.allowed) {
// v1.38.19 (Wave E, fix round 1) — say WHICH ceiling refused and WHOSE.
// v1.38.19 — say WHICH ceiling refused and WHOSE.
// `totalAfter` alone is the day's mixed total; on an operator refusal that
// is not the counter that tripped, and reading `totalAfter: 1200000`
// against a 200 000 ceiling is what turned the 06:42Z incident into a
@@ -654,7 +654,7 @@ async function handleChatRequest(request: NextRequest): Promise<Response> {
async function produceReply(): Promise<ReplyOutcome> {
let result: CompletionResult;
// v1.38.19 (Wave E) — typed as the chain's provider union, not a bare
// v1.38.19 — typed as the chain's provider union, not a bare
// string: the budget reconcile attributes the turn's tokens to the cost
// owner of the hop named here.
let workingProviderType: ProviderChainType;
@@ -120,9 +120,9 @@ describe("POST /api/labs/ocr/extract — text mode budget", () => {
"2026-06-26",
// F1 — the provider-aware daily cap (mocked) is threaded as the 4th arg.
200_000,
// Wave E — and the cost owner that cap is enforced against as the 5th.
// ...the cost owner that cap is enforced against as the 5th...
"operator",
// Wave E fix round 1 — the surface the ceiling is rationed for, 6th.
// ...and the surface the ceiling is rationed for as the 6th.
"coach",
);
});