Skip to content

docs(metadata-protocol): re-point the seed-exemption falsification instruction at its proven lever #18634

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
huangyiirene merged 1 commit into from
Sep 17, 2026
+12 −2
Merged

docs(metadata-protocol): re-point the seed-exemption falsification instruction at its proven lever #18634

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 12 additions & 2 deletions packages/metadata-protocol/src/seed-loader-state-machine-exempt.test.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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() {
Expand Down
Loading