@heixui/dsh-session-suite 0.4.2 → 0.4.4

package/client.js

@@ -143,6 +143,11 @@ window.__ModuleLoader__.load({
         'settings.budget': 'Keeps the newest {keep} automatic snapshots',
         'settings.budgetInherited': '+ {n} inherited',
         'settings.inherited': 'Inherited',
+        'settings.orphansSweep': 'Clean up orphan snapshots',
+        'settings.orphansConfirm': 'Click again to delete',
+        'settings.orphansNone': 'No orphan snapshot directories',
+        'settings.orphansFound': '{n} orphan session(s), {size} reclaimable — click again to delete',
+        'settings.orphansRemoved': 'Removed {n} orphan session(s), freed {size}',
         'settings.budgetNote':
           'Only this session\'s own automatic snapshots count against the budget. Snapshots inherited from a parent session (created by a rewind or message delete) are kept separately and are why the list can be longer than {keep}.',
         'settings.usage': 'Snapshots use {size}',
@@ -213,7 +218,16 @@ window.__ModuleLoader__.load({
         'memory.unfreeze': 'Unfreeze',
         'memory.remove': 'Delete',
         'memory.pendingTitle': 'Suggested memories',
-        'memory.pendingHint': 'Extracted from the last turns. Nothing is stored until you accept it.',
+        'memory.statsKind': 'What the library holds',
+        'memory.statsHealth': 'Score distribution',
+        'memory.statsTags': 'Topics',
+        'memory.kind.fact': 'Facts',
+        'memory.kind.rule': 'Rules',
+        'memory.kind.summary': 'Summaries',
+        'memory.kind.episode': 'Episodes',
+        'memory.band.high': 'Strong ≥0.60',
+        'memory.band.mid': 'Fading 0.45–0.60',
+        'memory.band.low': 'Below line <0.45',        'memory.pendingHint': 'Extracted from the last turns. Nothing is stored until you accept it.',
         'memory.extractionIdle': 'Nothing is waiting. Last check: {reason}',
         'memory.extractionNotYet':
           'Nothing is waiting yet. Extraction runs at the end of each turn, and this Host has not completed one since it started — have a short exchange and come back.',
@@ -254,6 +268,8 @@ window.__ModuleLoader__.load({
         'memory.extractionRejected': '{n} rejected as unusable',
         'memory.extractionEvents': '{n} session event(s) received',
         'memory.extractionTurns': '{n} turn(s) ended',
+        'memory.extractionRegistered': 'hook registered',
+        'memory.extractionNotRegistered': 'HOOK NOT REGISTERED',
         'memory.accept': 'Keep',
         'memory.reject': 'Discard',
         'memory.accepted': 'Kept',
@@ -372,6 +388,11 @@ window.__ModuleLoader__.load({
         'settings.budget': '每个会话保留最近 {keep} 个自动快照',
         'settings.budgetInherited': '+ {n} 个继承',
         'settings.inherited': '继承',
+        'settings.orphansSweep': '清理孤儿快照',
+        'settings.orphansConfirm': '再点一次确认删除',
+        'settings.orphansNone': '没有孤儿快照目录',
+        'settings.orphansFound': '{n} 个会话的孤儿快照，可释放 {size} —— 再点一次删除',
+        'settings.orphansRemoved': '已删除 {n} 个会话的孤儿快照，释放 {size}',
         'settings.budgetNote':
           '只有这个会话自己的自动快照计入预算。从父会话继承来的快照（回滚或删除消息时产生）单独保留，所以列表可能比 {keep} 长。',
         'settings.usage': '快照占用 {size}',
@@ -442,6 +463,16 @@ window.__ModuleLoader__.load({
         'memory.unfreeze': '解冻',
         'memory.remove': '删除',
         'memory.pendingTitle': '待确认的记忆',
+        'memory.statsKind': '库里有什么',
+        'memory.statsHealth': '分数分布',
+        'memory.statsTags': '主题分布',
+        'memory.kind.fact': '事实',
+        'memory.kind.rule': '规则',
+        'memory.kind.summary': '摘要',
+        'memory.kind.episode': '经历',
+        'memory.band.high': '强 ≥0.60',
+        'memory.band.mid': '衰减 0.45-0.60',
+        'memory.band.low': '低于线 <0.45',
         'memory.pendingHint': '从最近几轮里识别出来的，确认前不会入库。',
         'memory.extractionIdle': '当前没有待确认条目。上次检查结果：{reason}',
         'memory.extractionNotYet':
@@ -483,6 +514,8 @@ window.__ModuleLoader__.load({
         'memory.extractionRejected': '剔除 {n} 条',
         'memory.extractionEvents': '收到 {n} 个会话事件',
         'memory.extractionTurns': '结束 {n} 轮',
+        'memory.extractionRegistered': '钩子已注册',
+        'memory.extractionNotRegistered': '钩子未注册',
         'memory.accept': '保留',
         'memory.reject': '丢弃',
         'memory.accepted': '已保留',
@@ -993,6 +1026,53 @@ window.__ModuleLoader__.load({
   overflow-y: auto;
   overscroll-behavior: contain;
 }
+/* The summary charts. Two narrow panels for composition and health, one wide panel
+   for tags: composition and health are short lists, tags can run long. Bars are divs,
+   not SVG, so they inherit the theme and stay legible in both palettes. */
+.dss-stats { display: grid; grid-template-columns: repeat(2, minmax(0, 1fr)); gap: 10px; }
+.dss-stats-panel {
+  display: flex; flex-direction: column; gap: 8px;
+  padding: 14px 16px;
+  background: var(--dsw-alias-bg-layer-1, #fff);
+  border: 1px solid var(--dsw-alias-border-l1, rgba(0,0,0,.08));
+  border-radius: 10px;
+}
+.dss-stats-wide { grid-column: 1 / -1; }
+.dss-statbar { display: flex; align-items: center; gap: 10px; font-size: 12px; }
+/* The label was a fixed 76px with nowrap + ellipsis, so anything longer than a
+   couple of Chinese characters was cut off mid-word — 「低于压缩线（<0.45）」
+   rendered as 「低于压缩线…」 and the reader could not tell which band it was.
+   A wider column that wraps is the honest fix: a truncated label still occupies the
+   same space, it just stops being readable. */
+.dss-statbar-label {
+  flex: none; width: 108px;
+  color: var(--dsw-alias-label-primary, #1f1f1f);
+  line-height: 1.35;
+  overflow-wrap: anywhere;
+}
+/* Composition and tag bars get distinct hues — declared at the END of the sheet, next
+   to the fill rule, because source order decides between two single-class rules and an
+   earlier declaration lost to the fill's own background. */
+.dss-statbar-track {
+  flex: 1; height: 8px; min-width: 0;
+  background: var(--dsw-alias-bg-layer-2, #f2f3f5);
+  border-radius: 4px; overflow: hidden;
+}
+.dss-statbar-fill {
+  height: 100%; border-radius: 4px;
+  background: var(--dsw-alias-brand-primary, #2563eb);
+  transition: width .2s ease;
+}
+/* Health bands use the semantic colours the rest of the app already uses, so the
+   meaning does not depend on reading the label. */
+.dss-tone-good { background: var(--dsw-alias-state-success-primary, #1a9c50); }
+.dss-tone-warn { background: var(--dsw-alias-state-warning-primary, #d97706); }
+.dss-tone-bad { background: var(--dsw-alias-state-error-primary, #d93025); }
+.dss-statbar-value {
+  flex: none; width: 32px; text-align: right;
+  font-variant-numeric: tabular-nums; font-weight: 600;
+  color: var(--dsw-alias-label-secondary, #6b6b6b);
+}
 .dss-row {
   display: flex; align-items: center; gap: 10px; padding: 10px 12px;
   border-bottom: 1px solid var(--dsw-alias-border-l1, rgba(0,0,0,.06));
@@ -1037,6 +1117,21 @@ window.__ModuleLoader__.load({
 .dss-row-actions { display: flex; align-items: center; gap: 4px; flex: none; }
 .dss-spin { width: 14px; height: 14px; border-radius: 50%; border: 2px solid currentColor; border-top-color: transparent; animation: dss-spin .8s linear infinite; }
 @keyframes dss-spin { to { transform: rotate(360deg); } }
+/* Colour overrides, last in the sheet on purpose.
+   The first version put the hue classes before the fill rule, which sets a brand
+   background — so every bar rendered the same near-black colour and the chart looked
+   like five copies of one object. Source order decides here, not specificity: both are
+   single-class selectors. Declared last so the hue wins, and the double-class form for
+   the extra specificity that makes it survive a future rule added above. */
+.dss-statbar-fill.dss-tone-c0 { background: #4d6bfe; }
+.dss-statbar-fill.dss-tone-c1 { background: #7b5cf5; }
+.dss-statbar-fill.dss-tone-c2 { background: #2aa6c9; }
+.dss-statbar-fill.dss-tone-c3 { background: #14a37f; }
+.dss-statbar-fill.dss-tone-c4 { background: #e0a03a; }
+.dss-statbar-fill.dss-tone-c5 { background: #d9636a; }
+.dss-statbar-fill.dss-tone-good { background: var(--dsw-alias-state-success-primary, #1a9c50); }
+.dss-statbar-fill.dss-tone-warn { background: var(--dsw-alias-state-warning-primary, #d97706); }
+.dss-statbar-fill.dss-tone-bad { background: var(--dsw-alias-state-error-primary, #d93025); }
 `
 
     function installStyles() {
@@ -2295,6 +2390,9 @@ window.__ModuleLoader__.load({
       const [detail, setDetail] = useState(null)
       const [error, setError] = useState(null)
       const [busy, setBusy] = useState(null)
+      // Two-step confirm for the orphan sweep: the first click reports, the second
+      // deletes. Held in state so the button label can say which step it is on.
+      const [orphanArmed, setOrphanArmed] = useState(false)
       const [memoryDraft, setMemoryDraft] = useState('')
       // Kept for the memory.add API path that the long-term screen still uses; the
       // snapshot panel no longer renders a session-memory editor.
@@ -2429,6 +2527,44 @@ window.__ModuleLoader__.load({
           ? h('div', { className: 'dss-section-desc' }, t('settings.budgetNote', { keep: stats?.budget ?? 10 }))
           : null
 
+      // Reclaiming snapshot directories of deleted sessions.
+      //
+      // `#prune` only runs when a session takes another snapshot, so a deleted
+      // session's directory is never revisited and its blobs are never freed. The
+      // first click reports what would go; the second confirms. A destructive action
+      // that also runs on a timer is how people lose data they did not know they had,
+      // so the timer only reports and this control is the only thing that deletes.
+      const orphanLine = h(
+        'div',
+        { className: 'dss-toolbar' },
+        h(
+          'button',
+          {
+            type: 'button',
+            className: 'dss-btn dss-small dss-ghost',
+            disabled: busy === 'orphans',
+            onClick: () =>
+              run('orphans', async () => {
+                const result = await call({ action: 'sweepOrphans', apply: orphanArmed })
+                if (result?.orphans === 0) {
+                  notify(t('settings.orphansNone'))
+                  setOrphanArmed(false)
+                  return
+                }
+                if (!orphanArmed) {
+                  notify(t('settings.orphansFound', { n: result.orphans, size: result.freed }))
+                  setOrphanArmed(true)
+                  return
+                }
+                notify(t('settings.orphansRemoved', { n: result.removed, size: result.freed }))
+                setOrphanArmed(false)
+                bump()
+              }, null),
+          },
+          orphanArmed ? t('settings.orphansConfirm') : t('settings.orphansSweep'),
+        ),
+      )
+
       const checkpoints = detail?.checkpoints ?? []
       const checkpointList =
         checkpoints.length === 0
@@ -2574,11 +2710,116 @@ window.__ModuleLoader__.load({
         budgetNote,
         checkpointList,
         undoList,
+        orphanLine,
       )
     }
 
     // ------------------------------------------------------- long-term memory
 
+    /**
+     * One horizontal bar, drawn with a div rather than SVG.
+     *
+     * A bar chart of five rows does not need a charting library: a filled div inside
+     * a track is the whole implementation, it inherits the theme's colours, and it
+     * stays readable in both light and dark without any per-chart configuration. The
+     * value is printed next to the bar, because the bar communicates proportion and
+     * the number communicates quantity — one without the other is guesswork.
+     *
+     * @param {any} props row props
+     * @returns {any} row element
+     */
+    function StatBar(props) {
+      const { label, value, max, tone, hue } = props
+      const ratio = max > 0 ? Math.min(1, value / max) : 0
+      // `tone` is semantic (health bands); `hue` is positional (composition and tags).
+      // They are separate because one means "this is bad" and the other means "this is
+      // a different row" — conflating them would colour a healthy category red just
+      // because it happens to be fifth.
+      const fillClass = tone
+        ? ` dss-tone-${tone}`
+        : typeof hue === 'number'
+          ? ` dss-tone-c${hue % 6}`
+          : ''
+      return h(
+        'div',
+        { className: 'dss-statbar' },
+        h('div', { className: 'dss-statbar-label', title: String(label) }, label),
+        h(
+          'div',
+          { className: 'dss-statbar-track' },
+          h('div', {
+            className: `dss-statbar-fill${fillClass}`,
+            style: { width: `${Math.round(ratio * 100)}%` },
+          }),
+        ),
+        h('div', { className: 'dss-statbar-value' }, String(value)),
+      )
+    }
+
+    /**
+     * The memory summary: what the library is made of, and whether it is healthy.
+     *
+     * Each panel answers one question a reader would actually ask, and each implies a
+     * next action: a high rule count means maintenance is over-producing, a large
+     * "below threshold" band means decay is about to archive things, a lopsided tag
+     * list means one topic is crowding out the rest. Numbers nobody would act on are
+     * decoration; these are not.
+     *
+     * @param {any} props panel props
+     * @returns {any} summary element
+     */
+    function MemoryStats(props) {
+      const t = props.t ?? (key => key)
+      const stats = props.stats
+      if (!stats || typeof stats !== 'object') return null
+
+      const kinds = [
+        ['fact', stats.kind?.fact ?? 0],
+        ['rule', stats.kind?.rule ?? 0],
+        ['summary', stats.kind?.summary ?? 0],
+        ['episode', stats.kind?.episode ?? 0],
+      ].filter(([, count]) => count > 0)
+      const kindMax = Math.max(1, ...kinds.map(([, count]) => count))
+
+      const bands = [
+        ['high', stats.bands?.high ?? 0, 'good'],
+        ['mid', stats.bands?.mid ?? 0, 'warn'],
+        ['low', stats.bands?.low ?? 0, 'bad'],
+      ]
+      const bandMax = Math.max(1, ...bands.map(([, count]) => count))
+
+      const tagMax = Math.max(1, ...(stats.tags ?? []).map(item => item.count))
+
+      return h(
+        'div',
+        { className: 'dss-stats' },
+        h(
+          'div',
+          { className: 'dss-stats-panel' },
+          h('div', { className: 'dss-group-title' }, t('memory.statsKind')),
+          ...kinds.map(([kind, count], index) =>
+            h(StatBar, { key: kind, label: t(`memory.kind.${kind}`), value: count, max: kindMax, hue: index }),
+          ),
+        ),
+        h(
+          'div',
+          { className: 'dss-stats-panel' },
+          h('div', { className: 'dss-group-title' }, t('memory.statsHealth')),
+          ...bands.map(([band, count, tone]) =>
+            h(StatBar, { key: band, label: t(`memory.band.${band}`), value: count, max: bandMax, tone }),
+          ),
+        ),
+        h(
+          'div',
+          { className: 'dss-stats-panel dss-stats-wide' },
+          h('div', { className: 'dss-group-title' }, t('memory.statsTags')),
+          ...(stats.tags ?? []).slice(0, 6).map((item, index) =>
+            h(StatBar, { key: item.tag, label: item.tag, value: item.count, max: tagMax, hue: index }),
+          ),
+        ),
+      )
+    }
+
     function useWorkspacePath() {
       return runtime.resolveCwd?.() ?? runtime.cwd
     }
@@ -2965,6 +3206,9 @@ window.__ModuleLoader__.load({
       const [draftScope, setDraftScope] = useState('workspace')
       const [busy, setBusy] = useState(null)
       const [known, setKnown] = useState([])
+      // Aggregates for the summary charts, fetched separately so a slow list load
+      // never blocks the numbers from appearing.
+      const [stats, setStats] = useState(null)
       // Maintenance bookkeeping, so "did the timer ever run?" is a fact on
       // screen rather than something the user has to take on trust.
       const [maint, setMaint] = useState(null)
@@ -3022,6 +3266,9 @@ window.__ModuleLoader__.load({
         call({ action: 'longterm.workspaces' })
           .then(list => alive && setKnown(Array.isArray(list) ? list : []))
           .catch(() => alive && setKnown([]))
+        call({ action: 'longterm.stats' })
+          .then(data => alive && setStats(data ?? null))
+          .catch(() => alive && setStats(null))
         return () => {
           alive = false
         }
@@ -3260,12 +3507,23 @@ window.__ModuleLoader__.load({
               // Raw counts of what the Host actually delivered, so "nothing waiting"
               // can be told apart from "the hook never fired". Without this the two
               // states look identical on screen.
+              //
+              // `registered` is the third state: the hook was never installed at all
+              // (the optional registration threw), which is a different bug from
+              // "installed but never called".
               extraction
                 ? h(
                     'div',
                     { className: 'dss-row-meta' },
                     h('span', null, t('memory.extractionEvents', { n: extraction.eventsSeen ?? 0 })),
                     h('span', null, t('memory.extractionTurns', { n: extraction.turnEndsSeen ?? 0 })),
+                    h(
+                      'span',
+                      null,
+                      extraction.registered
+                        ? t('memory.extractionRegistered')
+                        : t('memory.extractionNotRegistered'),
+                    ),
                   )
                 : null,
             )
@@ -3569,6 +3827,7 @@ window.__ModuleLoader__.load({
         { className: 'dss-section' },
         head,
         pendingBlock,
+        h(MemoryStats, { t, stats }),
         explainBlock,
         tabs,
         filterBlock,

package/index.js

@@ -170,8 +170,25 @@ export function apply(ctx, config = {}) {
   const sweepMs = numberOr(config.sweepIntervalMs, 5 * 60 * 1000)
   if (sweepMs > 0) {
     ctx.effect(() => {
+      // Snapshot directories of deleted sessions are never revisited by the
+      // per-session prune, so they accumulate. Checked here rather than deleted:
+      // reclaiming disk on a timer without a record of what went is not something to
+      // do unattended, so this only reports and the settings page applies it. The
+      // check runs a quarter as often as the sweep — it lists sessions, which is
+      // more expensive than expiring a file.
+      let tick = 0
       const timer = setInterval(() => {
         void service.sweep().catch(error => log('sweep failed', error))
+        tick += 1
+        if (tick % 4 !== 0) return
+        void service
+          .sweepOrphanCheckpoints(false)
+          .then(result => {
+            if (result?.orphans > 0) {
+              log(`orphan snapshots: ${result.orphans} session(s), ${result.freed} reclaimable`)
+            }
+          })
+          .catch(error => log('orphan snapshot check failed', error))
       }, sweepMs)
       timer.unref?.()
       return () => clearInterval(timer)

package/lib/api.js

@@ -317,6 +317,15 @@ async function respond(service, deps, action, input) {
       // adapter and what each one advertises. Reading configuration to answer "what
       // can I call" was the mistake.
       return json({ ok: true, data: await service.longTermModels() })
+    case 'longterm.stats':
+      // Aggregates for the visual summary. Computed here rather than in the browser
+      // because the browser would have to fetch every row to count them, and the
+      // counts must match what the list shows — one source, one answer.
+      return json({ ok: true, data: await service.longTermStats() })
+    case 'sweepOrphans':
+      // `apply` must be explicit. A dry run is the default so a stray call can never
+      // delete snapshot directories, and the report says how much would be freed.
+      return json({ ok: true, data: await service.sweepOrphanCheckpoints(input.apply === true) })
     case 'longterm.settings':
       return json(
         input.patch

package/lib/checkpoints.js

@@ -652,6 +652,48 @@ export class CheckpointStore {
     }
   }
 
+  /**
+   * Find and remove snapshot directories whose session no longer exists.
+   *
+   * `#prune` only runs when a session takes another snapshot, so a session that is
+   * deleted — or removed by another tool — leaves its whole directory behind: index,
+   * manifests, and blobs. Nothing ever revisits it. The blobs are content-addressed
+   * and can be large, so this is real disk, not just clutter.
+   *
+   * The test for "orphan" is deliberately conservative: a directory is only removed
+   * when the Host has no session log for that id. A session that exists but has no
+   * snapshots yet is not an orphan, and a session whose log is temporarily unreadable
+   * must not be treated as gone — so the caller supplies the set of live ids rather
+   * than this module guessing at the Host's layout.
+   *
+   * @param {object} input input
+   * @param {Set<string>} input.liveSessionIds ids that still exist
+   * @param {boolean} [input.apply] delete for real; false only reports
+   * @returns {Promise<{ orphans: string[], removed: number, bytes: number }>} result
+   */
+  async sweepOrphans({ liveSessionIds, apply = false }) {
+    const ids = await this.#sessionIds()
+    const orphans = ids.filter(id => !liveSessionIds.has(id))
+
+    let bytes = 0
+    for (const id of orphans) {
+      bytes += await dirSize(this.sessionDir(id)).catch(() => 0)
+    }
+
+    let removed = 0
+    if (apply) {
+      for (const id of orphans) {
+        try {
+          await removeDir(this.sessionDir(id))
+          removed += 1
+        } catch {
+          /* one failure must not stop the sweep */
+        }
+      }
+    }
+    return { orphans, removed, bytes }
+  }
+
   async #sessionIds() {
     try {
       const entries = await fs.readdir(path.join(this.root, 'sessions'), { withFileTypes: true })

package/lib/memory-host.js

@@ -201,7 +201,17 @@ export function installMemory({ ctx, root, config, log }) {
   )
 
   // --- 3. Implicit extraction after a turn --------------------------------
-  safe('implicit extraction', () =>
+  safe('implicit extraction', () => {
+    // A startup marker, recorded before the listener is even registered.
+    //
+    // The whole question "why is the queue empty" has two halves that look identical
+    // on screen: the hook is not registered at all, or it is registered and never
+    // called. This records the first half so the trace can distinguish them — the
+    // block used to render only after extraction ran, so a dead hook produced no
+    // trace and therefore no diagnostics.
+    extractionTrace.registered = true
+    extractionTrace.registeredAt = Date.now()
+    publishExtractionTrace(engine)
     ctx.effect(
       () =>
         ctx.on('session/event', (session, event) => {
@@ -210,13 +220,19 @@ export function installMemory({ ctx, root, config, log }) {
           // The queue stayed empty for an entire session and the reason could have
           // been any of: the listener never fired, it fired but saw no `turn/end`,
           // `session.id` was not the shape assumed, or extraction ran and refused.
-          // Each has a different fix, so the trace records which one happened —
-          // "nothing waiting" with no counts is indistinguishable from "the hook is
-          // never called at all", which is exactly the state that wasted several
-          // rounds of guessing.
+          // Each has a different fix, so the trace records which one happened.
+          //
+          // These counters are published IMMEDIATELY, not in the finally below. The
+          // first version only published after extraction ran, so a session where the
+          // hook never fired left `lastExtraction` null and the settings page showed
+          // no counters at all — the diagnostic could not report the one case it
+          // existed for.
           extractionTrace.eventsSeen = (extractionTrace.eventsSeen ?? 0) + 1
+          extractionTrace.at = Date.now()
+          publishExtractionTrace(engine)
           if (!event || event.type !== 'turn/end') return
           extractionTrace.turnEndsSeen = (extractionTrace.turnEndsSeen ?? 0) + 1
+          publishExtractionTrace(engine)
           // A branded id is still a string at runtime; accept any non-empty one and
           // report the actual shape when it is not.
           const sessionId = session?.id
@@ -239,8 +255,8 @@ export function installMemory({ ctx, root, config, log }) {
             })
         }),
       'session-suite: implicit memory',
-    ),
-  )
+    )
+  })
 
   // --- 3b. Automatic maintenance -------------------------------------------
   // Scoring, decay, clustering, and cold archiving are otherwise only reachable
@@ -511,6 +527,12 @@ const extractionTrace = {
 
 /** @param {string} sessionId session being processed */
 function resetExtractionTrace(sessionId) {
+  // The counters survive a reset on purpose. They measure whether the hook is being
+  // called at all, which is a property of the process, not of one extraction attempt:
+  // clearing them here made every attempt look like the first one and erased the
+  // evidence the diagnostic exists to collect.
+  const eventsSeen = extractionTrace.eventsSeen ?? 0
+  const turnEndsSeen = extractionTrace.turnEndsSeen ?? 0
   extractionTrace.sessionId = sessionId
   extractionTrace.at = Date.now()
   extractionTrace.ok = false
@@ -520,6 +542,8 @@ function resetExtractionTrace(sessionId) {
   extractionTrace.produced = 0
   extractionTrace.queued = 0
   extractionTrace.rejected = 0
+  extractionTrace.eventsSeen = eventsSeen
+  extractionTrace.turnEndsSeen = turnEndsSeen
 }
 
 /**

package/lib/service.js

@@ -962,6 +962,102 @@ export class SessionSuiteService {
     return { sessionId, restored: true }
   }
 
+  /**
+   * Remove snapshot directories belonging to sessions that no longer exist.
+   *
+   * The live set comes from the Host's own session listing, not from our own files:
+   * a session that exists but has not snapshotted anything must not be mistaken for a
+   * dead one, and the Host is the only authority on what exists.
+   *
+   * @param {boolean} [apply] delete for real; false only reports
+   * @returns {Promise<{ orphans: number, removed: number, bytes: number, freed: string }>} result
+   */
+  async sweepOrphanCheckpoints(apply = false) {
+    const live = new Set()
+    try {
+      const controller = this.#service('sessionController')
+      const value = await controller?.list?.({})
+      for (const item of Array.isArray(value?.items) ? value.items : []) {
+        if (typeof item?.sessionId === 'string') live.add(item.sessionId)
+      }
+    } catch (error) {
+      // Without a trustworthy live set, doing nothing is the only safe answer: every
+      // directory would look like an orphan and the sweep would delete everything.
+      this.log('could not list live sessions; refusing to sweep', error)
+      throw new Error('could not list live sessions, so the orphan sweep was refused')
+    }
+    const result = await this.store.sweepOrphans({ liveSessionIds: live, apply })
+    return {
+      orphans: result.orphans.length,
+      removed: result.removed,
+      bytes: result.bytes,
+      freed: formatBytes(result.bytes),
+    }
+  }
+
+  /**
+   * Aggregate counts for the memory summary.
+   *
+   * Every figure here answers a question a reader actually asks about their own
+   * library: what is it made of (kind), where does it live (scope), how healthy is it
+   * (state and score bands), what is it about (tags). A dashboard that shows numbers
+   * nobody would act on is decoration; these five all imply a next action — a rule
+   * count too high means maintenance is over-producing, a low score band means decay
+   * is about to archive things, a lopsided tag means one topic is crowding the rest.
+   *
+   * @returns {Promise<any>} aggregates
+   */
+  async longTermStats() {
+    // `this.memory` is the per-session MemoryLedger, NOT the long-term engine — that
+    // one is assigned later as `this.longTerm`. Reading the wrong object is why every
+    // figure came back zero while the list showed 55 rows: the ledger is empty by
+    // design, so the summary was honestly reporting an empty library that the panel
+    // next to it was simultaneously disproving.
+    const engine = this.longTerm
+    if (!engine?.list) {
+      return { total: 0, active: 0, archived: 0, kind: {}, scope: {}, privacy: {}, bands: { high: 0, mid: 0, low: 0 }, tags: [] }
+    }
+    const rows = await engine.list({ scope: 'all' })
+    const active = rows.filter(row => row.archived !== true)
+
+    /** @param {any[]} list @param {(row: any) => string} key @returns {Record<string, number>} */
+    const tally = (list, key) => {
+      const out = {}
+      for (const row of list) {
+        const value = key(row)
+        out[value] = (out[value] ?? 0) + 1
+      }
+      return out
+    }
+
+    // Score bands match the engine's own thresholds so the chart and the behaviour
+    // agree: >=0.6 is comfortably alive, 0.45-0.6 is approaching the compress line,
+    // <0.45 is at or below it and is what maintenance will compress next.
+    const bands = { high: 0, mid: 0, low: 0 }
+    for (const row of active) {
+      const score = Number(row.score ?? 0)
+      if (score >= 0.6) bands.high += 1
+      else if (score >= 0.45) bands.mid += 1
+      else bands.low += 1
+    }
+
+    const tags = Object.entries(tally(active, row => (Array.isArray(row.tags) && row.tags[0]) || '未分类'))
+      .sort((a, b) => b[1] - a[1])
+      .slice(0, 10)
+      .map(([tag, count]) => ({ tag, count }))
+
+    return {
+      total: rows.length,
+      active: active.length,
+      archived: rows.length - active.length,
+      kind: tally(rows, row => row.kind ?? 'fact'),
+      scope: tally(rows, row => row.scope ?? 'workspace'),
+      privacy: tally(rows, row => row.privacy ?? 'internal'),
+      bands,
+      tags,
+    }
+  }
+
   /**
    * Every model this Host can actually call, for the extraction picker.
    *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@heixui/dsh-session-suite",
-  "version": "0.4.2",
+  "version": "0.4.4",
   "description": "Session checkpoints for DSH: rewind a conversation with its files and memory, permanent session deletion, and shareable exports",
   "type": "module",
   "main": "./index.js",