From 8a4d82c833afd9ca6581942b883a537a46c39c11 Mon Sep 17 00:00:00 2001 From: Claude Date: Thu, 17 Sep 2026 10:26:58 +0000 Subject: [PATCH] docs(metadata-protocol): re-point the seed-exemption falsification instruction at its proven lever MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The comment told a future debugger to revert `seedReplay` in `SEED_OPTIONS`. `SEED_OPTIONS` is now `{ context: SEED_WRITE_EXECUTION_CONTEXT }`, so that flag is no longer there to revert and the runnable falsification procedure reads as stale. Which of the two candidates in `execution-context.zod.ts` is the lever was measured, not read: deleting `seedReplay: true` from the VALUE turns both cases red (2 failed), while making the SCHEMA FIELD `seedReplay: z.boolean().optional()` required leaves both green (2 passed) — each leg rebuilt `@objectstack/spec` and proved the mutation reached `dist/`, since this suite resolves that dep through its export map. The comment now names the VALUE, the rebuild step, and the schema field as the decoy it measured to be one. Comment-only: no assertion, behaviour or published surface changes. Co-Authored-By: Claude Claude-Session: https://claude.ai/code/session_01CqmCgU5RGDoJYhHUMVp2af --- .../src/seed-loader-state-machine-exempt.test.ts | 14 ++++++++++++-- 1 file changed, 12 insertions(+), 2 deletions(-) diff --git a/packages/metadata-protocol/src/seed-loader-state-machine-exempt.test.ts b/packages/metadata-protocol/src/seed-loader-state-machine-exempt.test.ts index 1922eb4f82b..eb442fae22b 100644 --- a/packages/metadata-protocol/src/seed-loader-state-machine-exempt.test.ts +++ b/packages/metadata-protocol/src/seed-loader-state-machine-exempt.test.ts @@ -18,8 +18,18 @@ import { assertEngineDeleteDispatch, assertEngineUpdateDispatch, assertEngineFin * DEPENDS ON this package — importing it back would cycle. So this mock engine * reproduces the exact insert-time guard (reject a state ∉ initialStates UNLESS the * write carries `context.seedReplay`) to regression-test the loader's end of the - * contract in isolation. Revert the `seedReplay` flag in `SEED_OPTIONS` and both - * cases below go red — 4 of 5 rows rejected, the flag absent from the writes. + * contract in isolation. + * + * FALSIFY IT — the lever is one package away: `SEED_OPTIONS` no longer spells the + * flags inline, it is `{ context: SEED_WRITE_EXECUTION_CONTEXT }` (seed-loader.ts). + * Delete `seedReplay: true` from the `SEED_WRITE_EXECUTION_CONTEXT` VALUE in + * `packages/spec/src/kernel/execution-context.zod.ts`, rebuild `@objectstack/spec` + * (nothing aliases that dep back to source here, so this suite reads its `dist/`), + * and both cases below go red — 4 of 5 rows rejected, the flag absent from the + * writes. ⛔ NOT the `seedReplay: z.boolean().optional()` SCHEMA FIELD higher up in + * that same file: it governs what is ACCEPTED, not what the loader SENDS, and + * editing it leaves both cases green — measured, and the reason it is named here: + * a debugger who reaches for it reads a vacuous pass as a completed falsification. */ function createLogger() {