@gkorepanov/ccodex 0.4.9 → 0.4.11

package/dist/gateway/threadList.js

@@ -1,6 +1,7 @@
 import { createHash } from "node:crypto";
 import { queryFingerprint } from "../protocol/cursor.js";
 import { invalidParams } from "../protocol/errors.js";
+import { filterSortThreads } from "../store/threadFilter.js";
 function threadKey(params) {
     return params.sortKey === "updated_at" ? "updatedAt" : params.sortKey === "recency_at" ? "recencyAt" : "createdAt";
 }
@@ -26,33 +27,118 @@ async function allStockThreads(stock, params) {
     } while (cursor);
     return threads;
 }
-export async function mergedThreadList(params, stock, claude, cursors, logical, sideThreads) {
-    const [stockCatalog, claudeThreads] = await Promise.all([
-        allStockThreads(stock, { ...params, cursor: null }),
-        Promise.resolve(claude.listThreads({ ...params, cursor: null })),
-    ]);
-    const stockThreads = sideThreads?.filterThreads(stockCatalog) ?? stockCatalog;
-    const key = threadKey(params);
-    const direction = params.sortDirection === "asc" ? "asc" : "desc";
-    const query = threadQuery(params);
-    const cursor = cursors.decode("thread", params.cursor);
-    if (cursor && (cursor.query !== query || cursor.direction !== direction || cursor.key !== key || typeof cursor.value !== "number" || typeof cursor.id !== "string")) {
-        throw invalidParams("Thread pagination query changed; restart pagination.");
+export class ThreadCatalog {
+    stock;
+    claude;
+    cursors;
+    logical;
+    sideThreads;
+    constructor(stock, claude, cursors, logical, sideThreads) {
+        this.stock = stock;
+        this.claude = claude;
+        this.cursors = cursors;
+        this.logical = logical;
+        this.sideThreads = sideThreads;
     }
-    const anchor = cursor ? { [key]: cursor.value, id: cursor.id } : undefined;
-    const catalog = (logical ? logical.projectThreadCatalog(stockThreads, claudeThreads, params) : [...stockThreads, ...claudeThreads])
-        .sort((left, right) => compareThreads(left, right, key, direction))
-        .filter((thread) => !anchor || compareThreads(thread, anchor, key, direction) > 0);
-    const limit = Math.max(1, Math.min(params.limit ?? 50, 100));
-    const data = catalog.slice(0, limit);
-    const cursorFor = (thread, cursorDirection) => cursors.encode("thread", {
-        query, direction: cursorDirection, key, value: thread[key] ?? 0, id: thread.id,
-    });
-    return {
-        data,
-        nextCursor: data.length < catalog.length ? cursorFor(data[data.length - 1], direction) : null,
-        backwardsCursor: data.length > 0 ? cursorFor(data[0], direction === "asc" ? "desc" : "asc") : null,
-    };
+    async projected(params) {
+        // Provider-side filtering may hide a physical epoch before it can be
+        // projected to its public task. Only the archive partition is safe to
+        // apply before projection; every public filter is evaluated exactly once
+        // on the unified catalog.
+        await this.claude.refreshNativeMetadata?.();
+        const providerParams = {
+            archived: params.archived ?? false,
+            cursor: null,
+            limit: 100,
+        };
+        const [stockCatalog, claudeCatalog] = await Promise.all([
+            allStockThreads(this.stock, providerParams),
+            Promise.resolve(this.claude.listThreads(providerParams)),
+        ]);
+        const stockThreads = this.sideThreads?.filterThreads?.(stockCatalog) ?? stockCatalog;
+        const projected = this.logical
+            ? this.logical.projectThreadCatalog(stockThreads, claudeCatalog, providerParams)
+            : [...stockThreads, ...claudeCatalog];
+        return filterSortThreads(projected, params);
+    }
+    async list(params) {
+        const key = threadKey(params);
+        const direction = params.sortDirection === "asc" ? "asc" : "desc";
+        const query = threadQuery(params);
+        const cursor = this.cursors.decode("thread", params.cursor);
+        if (cursor && (cursor.query !== query || cursor.direction !== direction || cursor.key !== key
+            || typeof cursor.value !== "number" || typeof cursor.id !== "string")) {
+            throw invalidParams("Thread pagination query changed; restart pagination.");
+        }
+        const anchor = cursor ? { [key]: cursor.value, id: cursor.id } : undefined;
+        const catalog = (await this.projected(params))
+            .filter((thread) => !anchor || compareThreads(thread, anchor, key, direction) > 0);
+        const limit = Math.max(1, Math.min(params.limit ?? 50, 100));
+        const data = catalog.slice(0, limit);
+        const cursorFor = (thread, cursorDirection) => this.cursors.encode("thread", {
+            query, direction: cursorDirection, key, value: thread[key] ?? 0, id: thread.id,
+        });
+        return {
+            data,
+            nextCursor: data.length < catalog.length ? cursorFor(data[data.length - 1], direction) : null,
+            backwardsCursor: data.length > 0 ? cursorFor(data[0], direction === "asc" ? "desc" : "asc") : null,
+        };
+    }
+    async loaded(params) {
+        const hidden = this.sideThreads?.hiddenIds
+            ? { hiddenIds: this.sideThreads.hiddenIds.bind(this.sideThreads) }
+            : undefined;
+        return mergedLoadedList(params, this.stock, this.claude, this.cursors, this.logical, hidden);
+    }
+    async remoteSnapshot() {
+        const [active, archived, activeStock, archivedStock, activeClaude, archivedClaude] = await Promise.all([
+            this.projected({ archived: false }),
+            this.projected({ archived: true }),
+            allStockThreads(this.stock, { archived: false }),
+            allStockThreads(this.stock, { archived: true }),
+            Promise.resolve(this.claude.listThreads({ archived: false })),
+            Promise.resolve(this.claude.listThreads({ archived: true })),
+        ]);
+        const hiddenPhysicalIds = new Set(this.logical?.hiddenBackendIds?.() ?? []);
+        for (const id of this.logical?.catalogTombstones?.() ?? [])
+            hiddenPhysicalIds.add(id);
+        if (this.sideThreads) {
+            for (const id of this.sideThreads.hiddenIds?.([...activeStock, ...archivedStock]) ?? [])
+                hiddenPhysicalIds.add(id);
+        }
+        const durableRoot = (thread) => !thread.ephemeral && thread.parentThreadId === null;
+        const publicIds = new Set([...active, ...archived].map((thread) => thread.id));
+        for (const thread of [...activeStock, ...archivedStock, ...activeClaude, ...archivedClaude]) {
+            if (!publicIds.has(thread.id))
+                hiddenPhysicalIds.add(thread.id);
+        }
+        return {
+            active: active.filter(durableRoot),
+            archived: archived.filter(durableRoot),
+            hiddenPhysicalIds,
+        };
+    }
+    async reconcileRemote(sink) {
+        const snapshot = await this.remoteSnapshot();
+        for (const threadId of snapshot.hiddenPhysicalIds) {
+            sink("thread/deleted", { threadId });
+        }
+        const publish = (thread, archived) => {
+            sink("thread/started", { thread: { ...thread, turns: [] } });
+            sink("thread/name/updated", {
+                threadId: thread.id,
+                ...(thread.name === null ? {} : { threadName: thread.name }),
+            });
+            sink(archived ? "thread/archived" : "thread/unarchived", { threadId: thread.id });
+        };
+        for (const thread of snapshot.active)
+            publish(thread, false);
+        for (const thread of snapshot.archived)
+            publish(thread, true);
+    }
+}
+export async function mergedThreadList(params, stock, claude, cursors, logical, sideThreads) {
+    return new ThreadCatalog(stock, claude, cursors, logical, sideThreads).list(params);
 }
 async function allStockLoaded(stock) {
     const ids = [];

package/dist/gateway/threadList.js.map

@@ -1 +1 @@
-{"version":3,"file":"threadList.js","sourceRoot":"","sources":["../../src/gateway/threadList.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"threadList.js","sourceRoot":"","sources":["../../src/gateway/threadList.ts"],"names":[],"mappings":"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"}

package/dist/handoff/lineageStore.d.ts

@@ -0,0 +1,102 @@
+import type { Turn } from "../codex/generated/v2/Turn.js";
+import type { ProviderKind, ProviderEpochState } from "./store.js";
+export interface PublicTaskIdentity {
+    readonly publicThreadId: string;
+    readonly currentEpochId: string;
+    readonly revision: number;
+    readonly sessionId: string;
+    readonly createdAt: number;
+    readonly forkedFromId?: string;
+    readonly parentThreadId?: string;
+}
+export interface EpochBoundary {
+    readonly epochId: string;
+    readonly publicThreadId: string;
+    readonly ordinal: number;
+    readonly provider: ProviderKind;
+    readonly backendThreadId: string;
+    readonly state: ProviderEpochState;
+    readonly startTurnId?: string;
+    readonly endTurnId?: string;
+    readonly archivePending: boolean;
+    readonly deleteDone: boolean;
+}
+export interface LegacyBackendRef {
+    readonly provider: ProviderKind;
+    readonly backendThreadId: string;
+}
+export interface ProviderSegment {
+    readonly kind: "provider";
+    readonly position: number;
+    readonly epochId: string;
+    readonly startTurnId: string;
+    readonly endTurnId: string;
+}
+export interface SyntheticSegment {
+    readonly kind: "synthetic";
+    readonly position: number;
+    readonly publicTurnId: string;
+    readonly turn: Turn;
+}
+export type TranscriptSegment = ProviderSegment | SyntheticSegment;
+export type NewTranscriptSegment = Omit<ProviderSegment, "position"> | Omit<SyntheticSegment, "position">;
+export interface NewEpochBoundary {
+    readonly epochId: string;
+    readonly provider: ProviderKind;
+    readonly backendThreadId: string;
+    readonly state?: ProviderEpochState;
+}
+/**
+ * Minimal cross-provider source of truth.
+ *
+ * Provider-owned Thread, Turn and settings payloads deliberately have no column
+ * in this schema. Provider segments retain only the boundary IDs needed to read
+ * and slice the native provider transcript. Full JSON is accepted only for
+ * CCodex-owned synthetic turns. In-flight provider switches live in the
+ * operational journal, which is cleared when the transaction settles.
+ */
+export declare class LineageStore {
+    private readonly path;
+    private readonly database;
+    constructor(path: string);
+    close(): void;
+    createTask(identity: Omit<PublicTaskIdentity, "revision">, epoch: NewEpochBoundary): PublicTaskIdentity;
+    getTask(publicThreadId: string): PublicTaskIdentity | undefined;
+    listTasks(): PublicTaskIdentity[];
+    getEpoch(epochId: string): EpochBoundary | undefined;
+    listMappings(): EpochBoundary[];
+    listEpochs(publicThreadId: string): EpochBoundary[];
+    findEpoch(provider: ProviderKind, backendThreadId: string): EpochBoundary | undefined;
+    pendingStockArchives(): EpochBoundary[];
+    markStockArchived(epochId: string): boolean;
+    markEpochDeleted(epochId: string): boolean;
+    epochBelongsToLineage(publicThreadId: string, epochId: string): boolean;
+    epochReferenceCount(epochId: string): number;
+    taskEpochs(publicThreadId: string): EpochBoundary[];
+    deleteTask(publicThreadId: string): boolean;
+    createForkTask(identity: Omit<PublicTaskIdentity, "revision">, epoch: NewEpochBoundary, inheritedSegments: readonly NewTranscriptSegment[]): PublicTaskIdentity;
+    listSegments(publicThreadId: string): TranscriptSegment[];
+    replaceSegments(publicThreadId: string, expectedRevision: number, segments: readonly NewTranscriptSegment[]): boolean;
+    commitEpoch(publicThreadId: string, expectedEpochId: string, expectedRevision: number, sourceBoundary: {
+        readonly startTurnId: string;
+        readonly endTurnId: string;
+    }, target: NewEpochBoundary, syntheticTurns?: readonly {
+        readonly publicTurnId: string;
+        readonly turn: Turn;
+    }[]): PublicTaskIdentity | undefined;
+    commitRollback(publicThreadId: string, expectedEpochId: string, expectedRevision: number, target: NewEpochBoundary, retainedSegments: readonly NewTranscriptSegment[]): PublicTaskIdentity | undefined;
+    needsLegacyMigration(): boolean;
+    legacyBackendRefs(): LegacyBackendRef[];
+    finalizeLegacyMigration(validated: ReadonlySet<string>, backupPath?: string): void;
+    private createSchema;
+    private importLegacyLineage;
+    private migrateCatalogIdentities;
+    private importLegacyTurns;
+    private scrubLegacySnapshots;
+    private insertSegment;
+    private taskFromRow;
+    private epochFromRow;
+    private hasTable;
+    private userVersion;
+    private transaction;
+}