refactor(session): require known event types on read

scripts/gen-persistence-catalog.ts

@@ -368,7 +368,7 @@ export function render(events: AnnotatedLogEventEntry[], envelopeTypes: EventEnv
     '',
     'This file is GENERATED from source (`scripts/gen-persistence-catalog.ts`) and verified fresh by `pnpm run verify-persistence-catalog` (part of `doc-sync`) — do not edit it by hand. Declaration blocks retain the source declaration and nested property JSDoc, removing only the indentation imposed by a containing interface/module, and use a `ts persistence-catalog` fence (skipped by doc-typecheck because declarations reference types from their owning modules). Type names in a payload link to the page that documents them. See [the persistence-log-catalog Agent Note](../.agents/notes/archived/process/2026-07-04-persistence-log-catalog.md).',
     '',
-    'The envelope declarations below compose each event\'s `type`, monotonic `seq`, epoch-ms `time`, `data`, the optional `ignorable` unknown-type skip marker, and the conditional `surfaceOp`/`sourceEventSeqs` fields. **surface** marks a `SurfaceEventType` member: it produces an LLM message and declares how it joins the surface list. **log-only** marks everything else: a durable, replayable record with no derived-history contribution. Every payload is JSON-serializable (enforced at `Session.append`), and the whole format is pinned at `SESSION_FORMAT_VERSION = 0` — pre-release, no compatibility implied ([the version stance](subsystems/persistence.md)). Scope: the packages in this repo; a downstream plugin can merge further event types, which are outside this catalog by construction.',
+    'The envelope declarations below compose each event\'s `type`, monotonic `seq`, epoch-ms `time`, `data`, and the conditional `surfaceOp`/`sourceEventSeqs` fields. **surface** marks a `SurfaceEventType` member: it produces an LLM message and declares how it joins the surface list. **log-only** marks everything else: a durable, replayable record with no derived-history contribution. Every payload is JSON-serializable (enforced at `Session.append`), and the whole format is pinned at `SESSION_FORMAT_VERSION = 0` — pre-release, no compatibility implied ([the version stance](subsystems/persistence.md)). Scope: the packages in this repo; a downstream plugin can merge further event types, which are outside this catalog by construction.',
     '',
     '## Event envelope',
     '',
@@ -394,7 +394,7 @@ export function render(events: AnnotatedLogEventEntry[], envelopeTypes: EventEnv
 /**
  * Render the runtime known-vocabulary module: every event type the packages in
  * this repo can write, as a generated `ReadonlySet` the read path checks
- * unknown-type refusal against (`SessionEvent.ignorable` contract).
+ * before reconstructing a stored session.
  */
 export function renderKnownEventTypes(events: AnnotatedLogEventEntry[]): string {
   const names = [...new Set(events.map(e => e.name))].sort()
@@ -409,10 +409,9 @@ export function renderKnownEventTypes(events: AnnotatedLogEventEntry[]): string
     '/**',
     ' * Every `SessionEventMap` member declared in this repository — the event',
     ' * vocabulary this build understands. The persistence read path refuses to',
-    ' * interpret a log containing a type outside this set unless the event',
-    ' * carries the envelope\'s `ignorable` marker (see `SessionEvent.ignorable`',
-    ' * in `./types.ts`): such a log was likely written by a newer harness, and',
-    ' * silently skipping a required event would reconstruct a wrong session.',
+    ' * interpret a log containing a type outside this set: such a log was likely',
+    ' * written by a newer harness, and silently skipping the event could',
+    ' * reconstruct a wrong session.',
     ' * Downstream (out-of-repo) plugin events are outside this list by',
     ' * construction; a registration surface for them is deferred until such a',
     ' * consumer exists.',