@volter/supercode-interchange 0.1.13 → 0.1.14

package/index.d.ts

@@ -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 }>>;
@@ -115,6 +117,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';
@@ -17,4 +17,4 @@ export { codexNamesPath, readCodexNames, readCodexHistory, readClaudeTitles } fr
 export { enrichDescriptor, enrichIndexPage, 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.14",
   "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 = {} } = {}) {