refactor(compact): align compact/summary and CompactionResult on shadowed* naming

docs/core-data-structures/compaction.md

@@ -11,7 +11,7 @@ Compaction extends [`SessionEventMap`](session.md) with three event types via de
 | Event | Payload | Role |
 |---|---|---|
 | `compact/start` | `{ turn }` | acquires the log-recorded lock |
-| `compact/summary` | `{ summary, compactedRange, compactedEventSeqs, tokenCount }` | provenance: the summary blocks, the shadowed seq range, and the estimated token count |
+| `compact/summary` | `{ summary, shadowedRange, shadowedSeqs, shadowedTokenCount }` | provenance: the summary blocks, the shadowed seq range, and the estimated token count |
 | `compact/end` | `{ turn, error? }` | releases the lock (`error` set when summarization threw) |
 
 The lock brackets the **whole** operation: `compact/start` is appended first, then summarization, the `compact/summary` provenance record, and the `user/message` replacement all land, and only then `compact/end`. Releasing the lock last turns a crash mid-operation into a detectable orphaned lock (a `compact/start` with no matching `compact/end`) rather than a `compact/end` that falsely claims compaction finished.
@@ -37,7 +37,7 @@ interface CompactionResult {
   /** The seq numbers of all shadowed surface nodes. */
   shadowedSeqs: number[]
   /** Estimated token count of the shadowed content. */
-  compactedTokenCount: number
+  shadowedTokenCount: number
 }
 ```
 

packages/compact/compact/README.md

@@ -48,7 +48,7 @@ The `compact/*` events extend `SessionEventMap` (merge-extensible) via declarati
 | Event | Payload | On surface? |
 |---|---|---|
 | `compact/start` | `{ turn }` | no (log-only) |
-| `compact/summary` | `{ summary, compactedRange, compactedEventSeqs, tokenCount }` | no (log-only) |
+| `compact/summary` | `{ summary, shadowedRange, shadowedSeqs, shadowedTokenCount }` | no (log-only) |
 | `compact/end` | `{ turn, error? }` | no (log-only) |
 
 ## Implementing a backend

packages/compact/compact/src/types.ts

@@ -29,9 +29,9 @@ declare module '@deepseek-ai/dsh-session' {
      */
     'compact/summary': {
       summary: ContentBlock[]
-      compactedRange: { startSeq: number; endSeq: number }
+      shadowedRange: { start: number; end: number }
-      compactedEventSeqs: number[]
+      shadowedSeqs: number[]
-      tokenCount: number
+      shadowedTokenCount: number
     }
     /** Marks the end of a compaction — log-only, releases the lock. `error` set if summarization failed. */
     'compact/end': { turn: number; error?: string }
@@ -53,5 +53,5 @@ export interface CompactionResult {
   /** The seq numbers of all shadowed surface nodes. */
   shadowedSeqs: number[]
   /** Estimated token count of the shadowed content. */
-  compactedTokenCount: number
+  shadowedTokenCount: number
 }

packages/compact/compact/tests/compact.spec.ts

@@ -36,9 +36,9 @@ class StubCompactService extends CompactService {
     const startEvent = session.append('compact/start', { turn: 0 })
     const summaryEvent = session.append('compact/summary', {
       summary: [{ type: 'text', text: 'stub' }],
-      compactedRange: { startSeq: start, endSeq: end },
+      shadowedRange: { start, end },
-      compactedEventSeqs: [],
+      shadowedSeqs: [],
-      tokenCount: 0,
+      shadowedTokenCount: 0,
     })
     const endEvent = session.append('compact/end', { turn: 0 })
     return {
@@ -48,7 +48,7 @@ class StubCompactService extends CompactService {
       summary: [{ type: 'text', text: 'stub' }],
       shadowedRange: { start, end },
       shadowedSeqs: [],
-      compactedTokenCount: 0,
+      shadowedTokenCount: 0,
     }
   }
 }