@volter/supercode-interchange 0.1.13 → 0.1.15

package/discovery.mjs

@@ -3,7 +3,9 @@ import { readLatestCandidates, readFileTopics } from './previews.mjs';
 import { nativeTrim } from './text.mjs';
 
 /** Preview refusal preserves the native metadata row. The owner can retain
- * the exact failed source in diagnostics; it never invents message content. */
+ * the exact failed source in diagnostics; it never invents message content.
+ * A query that shows no message (`include_latest_candidates: false`, with no
+ * topics asked) opens no file: its row is the index's own. */
 export async function enrichDescriptor(query, descriptor, { codexTopics, metrics, previewFailure } = {}) {
   const row = { ...descriptor };
   const take = async (read) => {
@@ -17,7 +19,7 @@ export async function enrichDescriptor(query, descriptor, { codexTopics, metrics
     if (topics.length) row.preview_candidates = topics;
     else delete row.preview_candidates;
   }
-  const latest = await take(() => readLatestCandidates(row.locator, metrics));
+  const latest = query.include_latest_candidates === false ? [] : await take(() => readLatestCandidates(row.locator, metrics));
   if (latest.length) row.latest_message_candidates = latest;
   else delete row.latest_message_candidates;
   return row;
@@ -25,6 +27,8 @@ export async function enrichDescriptor(query, descriptor, { codexTopics, metrics
 
 /** Bounded enrichment belongs to returned/current-window rows. Metadata
  * maintenance never invokes this function, including unchanged warm queries. */
+export const readsPreviews = (query) => query.include_latest_candidates !== false || Boolean(query.include_topic_candidates);
+
 export async function enrichIndexPage(query, rows, options) {
   const result = [];
   for (const row of rows) result.push(await enrichDescriptor(query, row, options));

package/index.d.ts

@@ -29,7 +29,7 @@ export interface DiscoveryQuery {
   workspace?: string | null; workspace_subtree?: boolean; workspace_family?: string | null;
   updated_after_ms?: number | null; updated_before_ms?: number | null;
   query?: string | null; search_previews?: boolean; cursor?: string | null; limit?: number | null;
-  include_topic_candidates?: boolean; include_child_sessions?: boolean;
+  include_topic_candidates?: boolean; include_latest_candidates?: boolean; include_child_sessions?: boolean;
   root_session_id?: string | null; profile?: string | null;
 }
 export interface DiscoveryReceipt {
@@ -83,6 +83,8 @@ export function fileRoot(harness: HarnessId, homes: HarnessHomes): string | null
 export function sessionPartFor(harness: HarnessId, root: string, path: string): Promise<string | null>;
 export function listSessionParts(harness: HarnessId, root: string, options?: { folder?: string; beforeDirectory?: (path: string) => Promise<void>; metrics?: IndexMetrics }): Promise<{ parts: Set<string>; directories: Set<string> }>;
 export function readFileMetadata(harness: HarnessId, root: string, path: string, options?: { previous?: FileReadCache; projects?: Map<string, string>; nativeTopic?: (path: string, id: string) => string | null; metrics?: IndexMetrics }): Promise<{ descriptor: SessionDescriptor | null; cache: FileReadCache | null }>;
+/** The version of a harness's metadata reader; a part read by another version is read again. */
+export function metadataReaderVersion(harness: HarnessId): number;
 export function sourceStat(path: string): Promise<import('node:fs').BigIntStats | null>;
 export function sourceEntries(path: string): Promise<string[]>;
 export function selectStoreFiles(harness: HarnessId, homes: HarnessHomes): Promise<Array<{ path: string; profile: string | null }>>;
@@ -108,6 +110,7 @@ export interface DiscoveryEnrichmentOptions extends MetadataProjectionOptions {
   lateClaudeName?: (name: string) => Promise<string | null>;
 }
 export function enrichDescriptor(query: DiscoveryQuery, descriptor: SessionDescriptor, options?: DiscoveryEnrichmentOptions): Promise<SessionDescriptor>;
+export function readsPreviews(query: DiscoveryQuery): boolean;
 export function enrichIndexPage(query: DiscoveryQuery, descriptors: SessionDescriptor[], options?: DiscoveryEnrichmentOptions): Promise<SessionDescriptor[]>;
 export function discoverFromIndex(query: DiscoveryQuery, descriptors: Iterable<SessionDescriptor>, options?: DiscoveryEnrichmentOptions): Promise<DiscoveryPage>;
 export function nativeTrim(value: string): string;
@@ -115,6 +118,8 @@ export interface IndexMetadataRecord {
   source: string; part: string; row_key: string; descriptor: SessionDescriptor;
   mirror?: { harness: string | null; messages: number | null; continued: boolean; count: number } | null;
 }
+/** Whether a row stands for the session its key names: false for one that names that same key as its parent. */
+export function filedUnderOwnKey(descriptor: SessionDescriptor): boolean;
 export class RetainedMetadataProjection {
   constructor(query: DiscoveryQuery, sources: string[], records: Iterable<IndexMetadataRecord>, metrics?: IndexMetrics);
   updatePart(source: string, part: string, records: Iterable<IndexMetadataRecord>): void;

package/index.mjs

@@ -5,7 +5,7 @@ export {
   encodeDiscoveryCursor, decodeDiscoveryCursor, paginateDescriptors,
   discoveryReceipt, projectMetadataPage,
 } from './query.mjs';
-export { FILE_HARNESSES, STORE_HARNESSES, normalizedSourcePath, pathUnder, fileRoot, sessionPartFor, listSessionParts, readFileMetadata } from './source-layout.mjs';
+export { FILE_HARNESSES, STORE_HARNESSES, normalizedSourcePath, pathUnder, fileRoot, sessionPartFor, listSessionParts, readFileMetadata, metadataReaderVersion } from './source-layout.mjs';
 export { sourceStat, sourceEntries, selectStoreFiles, storeRegistryDirectories } from './store-registry.mjs';
 export { fileFingerprint, sameFingerprint } from './file-io.mjs';
 export { verifySources, readGeminiProjects, readSourceJson } from './source-files.mjs';
@@ -14,7 +14,7 @@ export { readForeignStore } from './foreign-store.mjs';
 export { readHermesStore } from './hermes-store.mjs';
 export { readOrchestratorStore } from './orchestrator-store.mjs';
 export { codexNamesPath, readCodexNames, readCodexHistory, readClaudeTitles } from './native-ledgers.mjs';
-export { enrichDescriptor, enrichIndexPage, discoverFromIndex } from './discovery.mjs';
+export { enrichDescriptor, enrichIndexPage, readsPreviews, discoverFromIndex } from './discovery.mjs';
 export { nativeInteger } from './native-json.mjs';
 export { nativeTrim } from './text.mjs';
-export { RetainedMetadataProjection } from './retained-projection.mjs';
+export { RetainedMetadataProjection, filedUnderOwnKey } from './retained-projection.mjs';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@volter/supercode-interchange",
-  "version": "0.1.13",
+  "version": "0.1.15",
   "type": "module",
   "description": "Read-only harness metadata, transcript codecs and session projections for Supercode",
   "license": "MIT OR Apache-2.0",

package/retained-projection.mjs

@@ -4,6 +4,10 @@ const order = (a, b) => a.rank - b.rank || Buffer.compare(Buffer.from(a.part), B
   || Buffer.compare(Buffer.from(a.row_key), Buffer.from(b.row_key));
 const originKey = (row) => JSON.stringify([row.source, row.part, row.row_key]);
 const partKey = (source, part) => JSON.stringify([source, part]);
+/** A row naming its own key as its parent is another transcript filed under that key (a child's file that carries
+ * its parent's id). It never stands for the session, whatever reader wrote it and whichever part sorts last. */
+export const filedUnderOwnKey = (descriptor) => descriptor.parent_session_id == null
+  || descriptor.parent_session_id !== descriptor.locator.session_id;
 
 /** A retained query owns one ordered metadata projection, shared by windows
  * with the same filters. An ordinary part update replaces only its connected
@@ -33,7 +37,8 @@ export class RetainedMetadataProjection {
   }
 
   #winner(key) {
-    const candidates = [...(this.candidates.get(key) ?? [])].map((origin) => this.origins.get(origin)).sort(order);
+    const candidates = [...(this.candidates.get(key) ?? [])].map((origin) => this.origins.get(origin))
+      .filter((row) => filedUnderOwnKey(row.descriptor)).sort(order);
     if (!candidates.length) { this.raw.delete(key); return; }
     // snapshot's deduplication keeps the last value, but the first occurrence
     // determines map iteration order (including native cross-harness families).

package/source-layout.mjs

@@ -82,6 +82,13 @@ export async function listSessionParts(harness, root, { folder = root, beforeDir
   return { parts, directories };
 }
 
+/** Each harness's metadata reader version, 1 where none is named. A change that makes a reader name a session
+ * differently from the same bytes (its key, its parent, the facts of its header) raises that harness's number: the
+ * daemon keeps the version each part was read with and reads again every part an older reader wrote
+ * (session-index-owner.mjs), since a file whose stamps hold is otherwise never read twice. */
+const METADATA_READERS = { 'claude-code': 2 };
+export const metadataReaderVersion = (harness) => METADATA_READERS[harness] ?? 1;
+
 /** All readers return one cache/descriptor unit. Cache identities and offsets
  * are committed beside the descriptor by the daemon, never by this library. */
 export async function readFileMetadata(harness, root, path, { previous, projects, nativeTopic, metrics = {} } = {}) {